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Section 1 
INTRODUCTION 


Computervision’s CGOS 200 GNA System Manager Guide is an introduc- 
tion and summary of key aspects of site management. This release of the 
Computervision Graphics Operating System (CGOS 200) features 
Graphics Network Architecture (GNA) that supports up to 10 simultaneous 
tasks. 


Providing step-by-step procedures, this publication guides the System 
Manager through system building and day-to-day operation. It also defines 
system configurations, the protection facility, and GNA. The final section 
alphabetically references the most-commonly used System Manager 
commands. 


The Table of Contents and Index provide quick reference to material 
throughout the manual. This publication is divided into eight sections: 


Section Title Contents 
1 Introduction | Highlights the Designer V and 
CV environment. 
2 CGOS Operating System Introduces the O/S and 
Graphics environment. 
3 Building a System. Procedures for: Loading O/S 
(Overview) | software (COLDSTART),_in- 


itializing file management 
(FMINIT), system re-start 
(Boot-Up), FMCLEAR, LOGIN, 


and LOGOUT. 
4 _ System Failures/Recovery 
Procedures 
5 Day-to-Day Operating Lists Start-up/Power-down 
Procedures procedures, error message 


changes, etc. 
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INTRODUCTION Section Title 
(Continued) > 
6 Specialized System 
Procedures 
7 Graphics Network 


Architecture 


8 System Commands 


Contents _ 


Supplies special system con- 
figuration information. 


Explains networking between 
CV systems. 


References all commands and 
presents, in detail, the most 
commonly used System 
Manager commands. 


Due to on-going hardware and software enhancements, some information 
in this manual may be superseded. Extensive, up-to-date documentation is 


stored on-line. On-line documentation 


command described in Section 8. 


is accessed with the HELP 


Notation Different type sizes and faces are used to distinguish between system and 


user responses. 
Exact 
USER INPUT ALL CAPS 


SYSTEM OUTPUT ALL CAPS, SMALL 


Variable 
Uppercase and Lowercase 


Uppercase and Lowercase 


TYPE FACE Small Type Face 
Symbol Meaning 
OTHER ) Carriage return. 
CONVENTIONS 
n> Operating System (O/S) level 
prompt for input. 
[ ] Optional material. 
() Choose between two or more 
items. 
CV Publications A complete list of CV Publications is available by contacting your CV 


representative. This list includes brief descriptions, prices, and recom- 
mended quantities for purchase of current user publications. 
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Training and 
Productivity 
Services 


TRAINING Technical training instruction is given at the Services Training Center, 
Woburn, Mass, and at CV Education Centers in Chicago and Los Angeles. 
Application Engineers and professional instructors are also available to 
come directly to your company. The current listing of courses, available in 
a quarterly brochure Educational Services Course Schedule, is obtainable 
through the Educational Centers Registrar (617) 935-9723. 


PRODUCTIVITY CV Productivity Services, available on a contract basis, focuses on the effi- 
SERVICES ciency with which your. Designer System is being operated, and its cost- 
effectiveness for your product. 


A two to three day, on-site review of your system in operation consists of 
operations personnel interviews, and investigations of your programming 
and operating system environment, overlay structures, file catalogs, and 
communications with mainframe computers. Resulting recommendations 
might include suggestions for improving operating procedures, making 
tasks more cost-efficient, and choosing/training more effective super- 
visors, operators, and other personnel. 


CV T.I.P.S. A quarterly publication, Techniques for [ncreasing Productivity on the 
System, is available for all Computervision systems users. For additional 
information regarding a T.I.P.S. subscription, and submittal of T.I.P.S. 
material, contact your CV representative. 


Bug Reporting To report a software bug, please call the Response Center in Woburn, 
| Massachusetts, 800-225-5376; Massachusetts users should call 
617-935-9723. A dispatcher will take the information and an applications 
engineer will return your call, normally within four hours, to discuss your 
problem. Each month you will receive a status report of all your software- 
related calls to the Response Center. 
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APPLICATIONS PACKAGES / 
COMMUNICATIONS SUPPORT 


Applications 
Packages 


Communications 
Support 


Installation of 
Communications 
Packages 


CGOS 200 GNA supports all CADDS 3 and CADDS 4 application 
packages. Some of the packages available are: 


e ACE (Architecture and Civil Engineering) 
MDD ~~ (Mechanical Design and Drafting) 

NC (Numerical Control) 

PC/ES (Printed Circuits/Electrical Schematics) 
Wiring Diagrams 


Contact your CV representative for a complete list of available software 
application packages. 


CGOS 200 GNA can communicate with other CV and non-CV systems. 
CGOS 200 GNA supports a number of communications packages. For 
data transfer between CGOS 200 systems, Graphic Networking Architec- 
ture (GNA) and CVNET are available. For data transfer between CV 
systems and other systems, CGOS 200 supports 2780, HASP, Honeywell 
GRTS, Univac 1004, and Sigma 7 protocols. These products require a pro- 
grammable communications unit (PCU) for their operation. Further details 
are available upon request. 


CV supports a variety of communications packages. Installation 
generally requires: | 


e Appropriate hardware (PCU or SLU board usually required). 


e Adding the hardware components to the system configuration. (See 
Section 6 for configuration details. ) 


e Installing the package via SYSCMTB command. (e.g., n>SYSCMTB 
CMTB.CV2780 installs CV2780 command.) 
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CGOS 200 GNA 
OPERATING 
SYSTEM 


PROGRAMMING 
SUPPORT 


Text Editors 


Programming 
Languages 


The Compiler 


The Loader 


Section 2 


THE OPERATING SYSTEM 


CGOS 200 GNA is a graphics-oriented, multi-user, multi-programming 
operating system developed by Computervision (CV). Supporting all 
CADDS 3 and 4 interactive graphics CAD/CAM applications, it uses CV's 
Graphics Processor, the CGP-200. 


CGOS 200 GNA is characterized by: 


¢ On-line software development aids. 


e Multi-user operation of up to eight interactive graphic workstations. 


¢ Sophisticated file management/command processing system. 


e Input/Output system designed to interact with and support a large 
variety of graphics and standard peripheral I/O devices. 


e Extensive CPU to CPU communications, including Graphics Network 
Architecture (GNA). 


CGOS supports three text editors for creating and modifying source files. 
(See EDIT, LONGEDIT, and CVTECO commands, Section 8.) 


EDIT 
CVTECO 
LONGEDIT 


FORTRAN-S 
TPL 


A simple, line-oriented editor for inputting text. 
A character-oriented text editor. 


A line-oriented editor that handles up to 
256-character line lengths. 


A subset of ANSI Standard FORTRAN. 


A high-level procedural language used for CV 
systems programming. TPL can go into assembly 
language when direct control of machine code is re- 
quired. 


Compiles a FORTRAN or TPL source file. 


Links and loads files of object code. The result is an overlay containing the 
absolute binary code to be executed at runtime. 
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Debugging Aids 


TASK INTERFACE 


Multi-User 
Environment 


BATCH 
PROCESSING 


EXECUTE 
FILES 


SYSTEM 
COMMANDS 


A symbolic subroutine trace is supported for runtime debugging along 
with a debugger designed for application use. (See DEBUG and TRACE 
command documentation in the CGOS 200 GNA Programmer Reference 
Manual.) | 


CGOS 200 GNA supports up to eight user tasks in the foreground and two 
more tasks in the background; making up to 10 tasks simultaneously 
operable. Processor time is priority-allocated. Short, interactive requests 
are allocated small amounts of CPU time; CPU-bound tasks get larger 
amounts of time at less frequent intervals. | 


Background processing support is provided on a resource-available basis. 
The system maintains a queue for batch jobs. The jobs receive CPU time 
depending on priority and the overall system load. Any Execute File can be 
submitted for batch processing. Batch processing commands are 
summarized in Batch/Execute File Processing Commands, Section 8. 


Generally, O/S commands are entered from the command device 
(COMDEV). To automate the process of entering a repetitive series of 
commands, an Execute File may be used. An execute file is a standard text 
file containing system commands. Execute files can invoke other execute 
files or batch programs. 


CGOS 200 GNA command syntax is very similar to CADDS 4 commands. 
There are over 100 standard system commands that an operator trained on 
CADDS systems can similarly use. Standard conventions facilitate the 
addition of new commands to suit specific needs. Users can develop and 
implement their own commands on a single-user or system-wide basis. 
(See Section 8 for brief descriptions of system commands. ) 


Task Interrupt 
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To interrupt task execution, the operator enters an ESCAPE or CTRL-B 
from his/her command device (COMDEV). Printing on the COMDEV or 
hardcopy device (HARDEV) is temporarily halted, and the task is now ina 
wait state. The wait state is either exited or continued by typing one of the 
characters below. Each character triggers a specific action: 


Interrupt Wait State Actions 
(Following an ESCAPE or CTRL-B) 


Character Action 
P Toggles HARDEV on/off; continues to wait. 
U Toggles the COMDEV on/off; continues to wait. 
B Ignores; continues to wait. 
ESCAPE Ignores; continues to wait. 
Q Aborts command. 
N Aborts command, terminates execute file, escapes to 
system level. 
K Aborts command, escapes to system level. 
1-9 The specified number of lines are output. The system 


then re-enters the Interrupt Wait State. 

P Outputs a page. (Lines per page is device-dependent.) 
The value for each device is one of the configuration 
parameters for the device. 


(Other) Task continues normal execution. 
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INPUT-OUTPUT Common |/O devices (magnetic tapes, line printers, card readers, paper | 

SYSTEM tape readers/punches, graphics and alphanumeric terminals, plotters, and 
data communication devices) are easily attached to any task. Once at- 
tached, devices may be accessed and controlled by commands entered at 
system level. CGOS supports no-wait //O, which lets operator input 
commands from his/her task while the |/O affecting that task is in pro- 
gress. The system supports certain standard naming conventions for 
accessing I/O devices. 


I/O Device Every tape unit and sulany device in the system can be referred to by one 
Names of three names: | 
e Unittype 


A generic four-character name for a class of units (e.g., TAPE, IOSB, 
INFO, TTYS, TBIO, TRMN,. .) 


e Uniqname 


A unique four-character name for each device (e.g., INFO, INF1,. .) 


e Taskunitname 


A two-character, user-assigned name for a device of exclusive access. 


TO ASSIGN A device must have a Taskunitname before it may be used. The ATTACH 
TASKUNITNAME command assigns a Taskunitname to the user device. | 
Example 
ATTACH CR,IOSB Attaches |OSB (name CR). 
ATTACH TT,TTYS Attaches Teletype™ (name TT). 


When the device is attached, the Taskunitname is used to access the 
device from a system command. 


Example 


SELECT HARDEV = TT Makes devices TT the HARDEV. 


DETACH ‘TT Detaches unit TT. 

RENAMDEV PT,CR Renames device PT; (new name CR). 
SPECIAL CM No device may be named CM. Any command 
CASES | using CM accesses COMDEV. 

SD The terminal the user logs in on is named SD 


by the LOGIN process. 
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MT Mag tapes are usually named MT. Any system 
command needing a tape unit name assumes 
“MT” unless another name is supplied. 


Example 

ATTACH MT, TAPE Attaches tape. 
REWIND MT Rewinds tape. 
REWIND Rewinds tape. 


Note 


See the CGOS 200 GNA Operator Guide for a 
full description of the ASCII character set, 
location of the keyboard characters, and 
special function characters. | 


Execution of system commands is globally affected by a set of special 
characters. Users interacting with the system, via a keyboard device, will 
send characters to the computer using the ASCII character set. Character 
positioning varies with different keyboards. Specific character positions 
are described on each of the following CV devices: 


TTY Teletype (ASR-33) 

INFO Infoton 

DEC Decwriter or Decscope (VT50) 
LEAR Lear Siegler (ADM-3A) 

lIOSB Telewriter 

INST Instaview Keyboard 


The Decwriter and Decscope keyboards are similarly arranged. The 
Decscope lacks certain keys (Repeat, and all lower-case characters) that 
the Decwriter has. 


Output can occur both on the command device (COMDEV) and the hard- 
copy device (HARDEV). 


e CTRL-P toggles the HARDEV. 
e CTRL-U toggles the COMDEV’S NOPRINT switch (on or off). 


CTRL-P and CTRL-U are operable only for the duration of a single 
command. 
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All card reader characters are listed in the CGOS 200 GNA Operator Guide. 


Special character sets are handled exclusively by the FUTIL CONVERT 
command. The following set descriptions can be used for reading from 
paper tape to a text file and punching a paper tape from a text file: 


e El for EIA 
e EA for an even parity ASCII 


For details and an explanation of how to generate and read these EIA 
tapes, please refer to the FUTIL and CONVERT commands described in 
the CGOS 200 GNA Operator Guide. 


The CGOS 200 GNA hierarchical file system supports sequential and 
random access file types of unlimited size. Each file contains information 
such as drawings, text, keyfiles, source code, executable code, or user- 
developed commands. 


All files in the file manager are assigned a file type according to the follow- 


ing scheme: 
File Types 
0 Not defined C-E Reserved 
1 Catalog F 280 Binary files 
2 Object 10-1F Reserved 
3. Text 20-2F Reserved for CADDS 4 
4 Configurations 20 CADDS Parts 
5 Reserved 21 TVF's 
6 PEP object code | 22 Figures 
7 Core image (overlay) 30-AF Reserved 
8 Command table BO-BF Reserved for 
9 Loader symbol table Batch Processing 
A Reserved _CO-FE Reserved 
B Accounting table FF Work Files 


The allowable character set for filenames is A-Z, 0-9, &, #, %, $,, +, —. 
lowercase is forced to uppercase. 


All catalogs associated with text files have an &BCD level. Each text file 
has &BCD as the next-to-last level of its name. (e.g., Catalog name = 
Foo; Foo .&BCD contains Foo’s text files.) 
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COMMANDS 


File Management 
Catalog Structure 


SAMPLE 
FILENAMES 


In referring to a text file, the &BCD level of the filename is sometimes omit- 
ted. Certain system level commands are uniquely associated with text files. 
When using these commands, omit the &BCD. All other commands 
require that the &BCD be specified. 


Filenames consist of one or more levels. A period is the de/imiter between 
levels. Each level can be up to 20 characters in length; the total character 
count for a filename cannot exceed 80 characters. Any file access in com- 
mand descriptions refers to file manager files. 


Catalogs have a multi-level structure: files that are members of one catalog 
may be subcatalogs with additional files. The main level catalog is called 


SYSCATLG. 
MASTER CATALOG (SYSCATLG) 
y ! ! S. 
if FILE ! \ 
/ 
CATALOG1 CATALOG2 .. .CATALOGn 
ca ! ! ~ | 
y, | \ 
Fi FILE1 | \S FILE1 
/ | me 
SUBCATALOGA : SUBCATALOGC 
| 
/ | 
Zi ! SUBCATALOGB 
/ | | 
/ l | 
File1 | File3 
File2 


Sample Filenames 


(Based on the preceding diagram): 
File1 


CATALOG1.SUBCATALOGA.File1 
CATALOG1.SUBCATALOGB.File3 
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To accomodate Graphics Network Architecture (GNA), an additional level 
has been added to the filename. This level designates the node where the 
file is located. (Default = node being worked.) The node level, if used, is 
the highest (leftmost) level. There are now four types of levels in a 
filename. 


Example 


[1].*VOLUME.CATLGA.CATLGB.CATLGC. FILENAME 


NODE VOLUME CATALOG | FILENAME 
LEVEL LEVEL LEVELS LEVEL © 


The above is a complete filename. The file data is located at node 1 in the 
network on the volume with the name VOLUME.CATLGA.CATLGB. 
CATLGC.FILENAME specifies a _ on the volume to data contained in 
FILENAME. 


The following conventions are associated with the four types of levels in a 
filename: 


NODE LEVEL 


e Purpose 


When systems are networked under GNA, the node level specifies the _ 
system (node) where file data | is located. Only one node level is valid ina 
full name. . 


e Format 
[n] where n is an integer of 0-6 inclusive, and the square brackets are 
part of the node level. 


VOLUME LEVEL 


e Purpose 


When an auxiliary disc volume is used, the volume level specifies which 
volume of the node file data is located at. Default is primary disc. Only 
one volume level may be used in a full name. 


File Naming 
Conventions 
(Continued) 


File Naming 
Restrictions 
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e Format 


A character string of at least one but no more than 20 characters (begin- 
ning with an *) that indicates the file manager name. 


CATALOG LEVELS 


e Purpose 


These specify a path on the volume to the file data. Multiple catalog 
levels are valid in a full name. 


e Format 


A character string of at least one but no more than 20 characters in- 
dicating the file manager name. | 


FILENAME LEVEL 


e Purpose 


Specifies entry of the last catalog level in which the file data resides. 
The filename may be a catalog, but it must be the last level in a full 
name. 


® Format 


A character string of at least one but no more than 20 characters in- 
dicating the file manager name. 


e A full name, including delimiters, may contain no more than 80 char- 
acters. When Working Directories are enabled, any filename entered by 
a user is joined with the directory entry. The joined name, usually not 
listed, is still restricted to 80 characters. 


e Levels between delimiters are limited to 20 characters. 


e These characters may be used to indicate the file manager name: 0-9, 
A-Z, +, —, @, #, $, & %. 


Note that [,] and * are special characters used as node and volume level 
identifiers only. 


@ Node and volume levels may be omitted from a name. If the node level 


is omitted, the default is the primary drive on the node specified. If both 
are omitted, the default is the primary drive on the local node. 
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Disc Volumes 


MULTI-VOLUME The system’s primary disc volume is mounted on physical drive 0. The O/S 

CONTROL and the previously mentioned Master Catalog are on this primary volume. 
Additional (auxiliary) disc volumes may be mounted in drives 1, 2, and 3. 
These commands are used with auxiliary disc volumes: 


¢ ENABVOL Incorporates an auxiliary volume’s file structure into 
the Master Catalog on the primary volume. 


¢ DSABVOL Removes an auxiliary volume’s file structure from the 
Master Catalog on the primary volume. 


e ATCHVOL Attaches a specific auxiliary disc volume to a task. 
e DICHVOL Detaches an auxiliary disc volume from a task. 


All volumes, except the primary volume, may be physically dismounted 
while the system is running. 


SINGLE DISC All drives configured on a controller can be initialized (via FMINIT) to be 

CONTROL treated as one logical disc. Disc packs initialized for sing/e disc control 
must be used on the same drives they were initialized on; they are treated 
as one continuous logical disc. 


File and Every file and command is designated as a member of a protection group. 
Command You assign Protection Groups to control user-access to specific 
Protection commands and files. The File Protection Facility is described in Section 6. 
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Section 3 
BUILDING A SYSTEM 


The following special procedures prepare the Designer IV and V Systems for 
operation and receiving new software. 


This procedure defines the disc’s data format and executes hardware error 
diagnostics. When new or previously used disc packs are successfully for — 
matted via FM Formatter or Magload tape, the O/S can be loaded from tape 
onto disc. 


The O/S maintains and supervises computer system operation. O/S com- 
mands enable direct user-control of system operation. 


O/S loading involves configuring the system by: selecting hardware com- 
ponents, tasks, and software features, allocating memory space for system 
functions/tasks, and loading configured O/S software onto the primary 
system volume via the COLDSTART tape. 


Initialization establishes: the disc pack name, volume number and protec- 
tion group, a file system, accounting and/or authorized LOGIN capabilities, 
the authorize file and access tables, and the disc area reserved for applica- 
tion, temporary, and scratch files. 


(Option) FMINIT, executed on auxiliary volumes, enables multi-disc volume 
usage. See FMINIT, Sections 3, 6, and 8. 


CV application software performs specialized processes. CADDS, PEP, 
POST, DOC, and other customer-ordered software (henceforth called 
application software) is stored on separate tape(s). These files are restorable 
when the O/S is initialized with the FUTIL file transfer utility. 


The SYSCMTB command (see Section 8) enables certain features and 
specially activated commands. When CADDS 3 software is completely 
loaded, the command CADDSCLR must be performed on each task to 
initialize task areas and set default parameters. (CADDSCLR is not done on 
CADDS 4 Systems.) 
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LOADING AND | Note 

INITIALIZING 

APPLICATION ~Boot-Up, Login, and LOGOUT instructions 
SOFTWARE (after the system has been initialized) are con- 
(Continued) tained in Section 3, Restarting System 


Procedures. When appropriate software exists 
in the system, you will want to skip the pro- 
cedures Formatting the Storage Module 
through FMINIT and begin initializing the 
application software. 


The system is now ready for use. Detailed instructions follow. 


FORMATTING Discs must be formatted before being loaded with software. (Format new 
THE STORAGE or faulty disc packs first.) IF DISCS ARE FORMATTED WITH EXISTING 
MODULE SOFTWARE, ALL DATA IS LOST. SAVE ALL SOFTWARE (ON TAPE 
DISC PACK OR ANOTHER DISC PACK) BEFORE FORMATTING. 
MSC-1300 (The left column defines the procedure; the right column clarifies the 
Controller action.) | 
Dialogue 

¢ Install the FM Formatter mag- The disc should be powered- 

netic tape on the tape drive up and READY. 


and put it on-line. 


e Press APL switch to APL2 The tape advances, rewinds, 
for magnetic tape load and dialogue begins: 
® CV FM FORMATTER | Do not type ) here. 


RIGHT (C) COMPUTERVISION, 
ALL RIGHTS RESERVED. 


Type HELP ) if assistance needed. 


(Date Tape Released). 
e+) Formatter Prompt. 


Type SELECT DPUTEST }) | DPUTEST is loaded into 
memory, and rewinds. Tape 
can be removed. 
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@ DRIVES TO TEST: 0 


@ FORMAT THE PACKS? (1=yes,0=no):1 
DRIVE TYPE: 80 MB ) 


© FORMATED DRIVE: 000000 ) 


@ FUNCTIONAL TESTS COMPLETED 
FOR DRIVE 000000 


Up to four drives may be 
tested; input additional drive 
numbers in the form 1,2,3. 


Either 80 MB or 300 MB is 
listed, depending on module 
size. Verify. 


Module formatting begins; 
consult field engineer should 
error occur. 


Module formatting is com- 
plete. Diagnostics begin. 


This message indicates suc- 
ccessful completion. 


Errors below sector 0900x affect system opera- 
tion; errors above O900x may affect data 
storage and recovery (CHKDISC should be ex- 
ecuted during FMINIT.) A CV field engineer 
should be consulted when discs show severe 


errors during formatting. 


Assuming there are no errors, the storage module is formatted. Proceed to 


COLDSTART. 


CGOS 200 GNA supports an 80 and a 300 megabyte storage module. *(If 
the module is new or suspected bad, execute Test A; otherwise, Tests |, F, 


and Y are sufficient.) 


(The left column defines the procedure; the right column clarifies the 


action.) 


e Load magnetic tape labeled 


MAGLOAD on tape drive and 


put it ON-LINE. 
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Telefile 
Controller 
Dialogue 
(Continued) 
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Press APL switch to APL2 
for magnetic tape load. 


Enter tape file # (0-9) 
containing desired program 
1 


Type filename (or type N 
to list filename & 
function) ) 


TELEDIG16 
REV.3.0 PATCHED 5-26-81 


Change two TELEDIAG 16 
program instructions for 
the 300 megabyte storage 
module. 


Depress / key on TTY to 
start: 


TELEDIAG16: 


ENTER CODE: 
E } 


256 WORDS? 
Ys 


IS THIS OK? 
Y > 


ENTER DC-16 DEVICE 
ADDRESS 


36 } 


Tape advances, rewinds, — 
and dialogue begins. 


Do not type ) here. 


Tape advances and rewinds. 
When tape stops, type 
backslash ( \ ) to start TELE- 
DIAG16. 


Stop, Examine location 136, 
Deposit 23, Examine Loca- 
tion 746, Deposit 23, Exam- 
ine location 40, Stop/Reset/ 
Start. 


Drive Type Codes are: 


A = 1677 
B = TT50 
C = TT80 
D = T9760 
E = T9762 


Standard DC-16 with: 32 . 
records. 


Highest Core Address Below 
Loader = 077640 I/O buffer 
size = 032430 


("33-"76) 
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@ ENTER MASK BIT: 


9) 


@ ENTER DRIVE 


0) 


TWO OR MORE DRIVES IN 
USE? 
N) 


@ RESET READ-ONLY SWITCH 
FOR DRIVE O ) 
READY? Y } 


@ PATTERN # 


10 } 


@ YOU HAVE SELECTED 
WORST } 


@ MOUNT SCRATCH PACK(S)? 


READY? Y } 


® PACK ‘DIAG’ FORMATTED? N } 


@ REST OF PACK ZERO TRACK ID? 


Y> 


@ RESET CONSOLE SWITCHES 


READY? } 


@ ENTER TEST: 


I) 


(0-3) 

(Assumed that system has 
only one storage module 
drive. If more, and you wish 
to format a disc on a drive 
other than drive O, enter 
number of that drive. 


Make sure the drive is not 
WRITE protected. 


(0-9 or >10) 

During formatting, data Is 
written on disc in a pattern 
selected at this point. 


Make sure all switches on 
data switch register are 
down, in 0 position. 


Test | initializes drive, insur- 
ing that the drive controller ts 
on-line. 


DTEX tape may be removed. 
COLDSTART Tape may be 
mounted in anticipation of 
loading CGOS. 
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Controller 
Dialogue 
(Continued) 


LOADING THE 
O/S (COLD- 
START) 


COLDSTART 


express written consent of Computervision. 


Test F verifies Leader loca- — 
. tions. Any errors en- 
@ ENTER TEST: countered in formatting are 

F ) printed between here and 
next message. 


© END TEST 


PACK DIAG FORMATTED 
END TEST.F 


@ ENTER TEST: Test Y writes and reads 
Y } | blocks of data to verify cor- 
rect operation. (Take a long 

coffee break.) 


@ READ/HEAD ANALYSIS 
NO ERRORS 


@ ENTER TEST: 


@ PRESS STOP/RESET SWITCH 
TO STOP, THEN RESET. 


Assuming there are no errors, the storage module is formatted. Proceed to 
to COLDSTART. 


When the disc is successfully formatted, the O/S is initialized. The 
COLDSTART process builds the system configuration and loads the O/S 
software from the COLDSTART tape onto disc. 


The new CV COLDSTART tape contains configurations and CGOS soft- 
ware. Configurations (pre-defined) reside in slots 0-11; the customer- 
tailored configuration contained in slot 0. Modifications are possible under 
special circumstances (see Section 6). 


Mount. and power-up disc, mount COLDSTART tape on tape drive. Set 
console switches 4 and 5 (located behind CGP-200 maintenance control 
panel) to select system device. 
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LOADING THE User-interactive devices and location of boot-up message are selected by 
O/S (COLD- these switch settings (UP = 1 and DOWN = 0): 
START) 
(Continued) Switch Switch Device Device 
4 5 Code Type 
UP DOWN 08-09 TTY 
DOWN DOWN 28-29 INFO 
DOWN UP 20-21 lOS 
UP UP OF LPT (output only: not 
for interactive 
use) 


Press APL2 switch. 


CGOS (date) (See ‘‘Boot-up’’, this section.) 
COMPUTERVISION CORP. CS# and version date varies. 
CGOS 200/10 CS#58 

VERSION DATE 4-7-81 


TYPE OK ) TO CONTINUE 


ENTER CONFIGURATION # ) Refer to COLDSTART tape 
label for correct configuration 
#. 

***0010 0780 RESTORED*** Output to indicate the system 
has been brought in from tape 
to disc. 

TYPE OK TO INDICATE | ) if no File Manager exists on 

FILE MANAGER IS ON DISC the disc (i.e., when building or 


rebuilding a pack). 
TYPE OK ) TO | Suppress optional BLDSYS 


SUPPRESS PRINT print-out; not needed by 
general user. (See Section 8.) 
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3-8 


Building a System. 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


The following. information — 
varies, depending on config- 
uration used: 


WORDS AVAILABLE: 


SHARED OS>COF 0016 FROM 0C10 TO 0C26 
KERNAL 051A FROM 5400 TO 59A1 
BOOT CODE 0018 FROM 0020 TO  003B 
SHARED OS>COF 03CA FRP, 0786 TP OBS5O 
DATA CHAN PAGE 796 FROM 7000 TO 7796 
UNINIT DATA 0043 FROM 50ED TO 5130 
****CGOS 200/10**** System boot-up message. 


The system is now configured and the CGOS loaded onto disc. 
Duplicating the COLDSTART tape is recommended, especially if the Pro- 
tection Facility is desired (see GENSLTAP, Section 8). When an existing 
configuration must be changed, refer to Section 6. 


CGOS software has been loaded on the disc (the system is booted-up). 
CGOS initialization begins with the following Login dialogue. 


After the system has been booted up from disc, you may Login to a system 
task. (The left column outlines the procedure; the right column clarifies the 
interaction. ) 


CTRL-L (or CTRL-Rn) Key-in either command, depending on the task 
| number you want to access: 


e CTRL-L 


Used in most cases; the Login procedure © 
assigns you the next available task if there is 
one available. 


e CTRL-Rn 


Used to LOGIN to a specific task. Type in 
CTRL-R followed by n (n=desired task 
number). Your terminal is assigned as the 
command |/O device (COMDEV) for the 
task. VOTE: the system does not respond to 
a larger task number than the number of 
tasks available, or a task number that is 
already logged in. 


Login 
(Continued) 
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**FMCLEAR** 


FILE STRUCTURE NOT 
FOUND ON DISC 


TYPE BOOT PASSWORD 


INVALID ENTRY, 
RESTART LOGIN 


TYPE TIME AND DATE 
MM-DD-YY(,HH:MM) 


TYPE NAME, NUMBER 


TYPE PASSWORD 


INVALID ENTRY 


**TASK n INITIATED** 


If you are the first person to Login after the 
system is booted up, this message appears. 
See FMCLEAR command for response to 
FMCLEAR output 


lf FMINIT was not previously run (new pack), 
this message appears. 


If FMINIT has been run and authorized boot-up 


was selected, you are asked to enter the 


authorized boot-up password (6 characters). 


This message is output if the password entered 
does not match the password specified in 
FMINIT. Restart Login by typing CTRL-L or 
CTRL-Rn. 


Under FMINIT, you are asked to set the system 
clock. (Based on 24-hour clock, e.g., 1:00PM 
= 13:00.) 


MM = month hh = hour 
DD = date mm = minute 
YY = year 


This message is output when system account- 
ing logs and system authorize features are 
enabled. Enter name (up to 20 alphanumeric 
characters), comma, and a number (up to 13 
digits). 


System response when the system authorize 
feature is enabled. Input a valid password (up 
to six characters). Your password must corre- 
spond to the system authorize file entry which 
is associated with your name and number. As 
your password is typed, the system will echo 
blanks. 


This message is output if the password is not 
valid for the given name and number. You must 
begin again by typing CTRL-L or CTRL-Rn. 


Output when Login is complete and the task is 


ready to use the system (n=task number 
assigned to you). 
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n> 


System prompt. The task is ready to accept 
command input. If file management is enabled, 
the system attempts to execute the first file in a 
hierarchy of user-created execute files, if any 
exist: 


1. SYSEXEC.BOOT-UP (Only for the first 
Login after boot-up.) 


2. USERNAME.LOGINEXEC (USERNAME = 
your LOGIN name.) The text file USER- 
NAME.LOGINEXEC is executed. 


3. SYSEXEC.LOGINnn (nn = two-digit hex- 
adecimal task number.) Task-specific files 
are only executed for the task numbered 
nn. 


SYSEXEC.LOGIN 
5. SYSNEWS.&BCD.LCLNEWS 


The system executes the first file in the hierar- 
chy that exists. When execution is complete, 
the system prompt is Issued. If file management 
is enabled and none of the files exist, or file 


management is disabled, the system prompt 


(n>) is issued immediately after the message: 
**TASK n INITIATED**. 


Login is complete; proceed with O/S and file manager initialization. 


Exception 


When disc pack contains a CGOS 200 GNA 
file manager which is to be retained, skip to 
Loading and Initializing Software. However, 
should a Login error message appear, skip 
instead to Crash Recovery Procedure. 


Accounting 
Operation/ 
Authorized 
Login Option 


USER LOGIN 
MODES 
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During Login, an operator supplies an account number in addition to his/ 
her job name and corresponding password. You, as System Manager, 
retain detailed user accounting information (on-system time, etc.). 


With CGOS 200/10, accounting logs are kept as file manager files in the 
catalog SYSTEM.LOG. You can save these files on tape, or copy them 
into other files for archival purposes. The charge rate (COST/MIN) is set 
during the FMINIT procedure. (See FMINIT, Section 8). 


To access accounting log maintenance operations, the operator logs in 
while you invoke the OPLOG command. (See OPLOG, Section 8.) 


Mode Description Action 


*CONTROLLED Login restricted to 1. See FMINIT. 
user specified in 
authorized file; selected 2. See Protection Facility, 
user access of certain Section 6. 
files/commands. 
3. See Loading and !nitializ- 
ing Application Soft- 
ware. 


*USAGE LOGS System records user’s 1. See FMINIT. 
time. 


NO 


. See Login Accounting 
Procedure. 


3. See Loading and Initializ- 
ing Application Soft- 


ware. 


UNCONTROLLED Any person may Login 1. See FMINIT. 


USER ACCESS and access any file; 
system doesn’t record 2. See Loading and Initializ- 
time. ing Application Soft- 


ware. 


*CONTROLLED USER ACCESS and USAGE LOGS mode procedures may be 
followed in conjunction. 
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FMINIT should now be done to initialize the file manager and the O/S. 


_FMINIT, executable on auxiliary volumes, is an option to enable multi-disc 


volume usage. 
Note 
FMINIT command documentation, is con- 


tained in Section 8. 


When the O/S and file manager are initialized, application software is 
loaded and initialized (if required). If previously saved application software 
is to be used instead, the System Manager can LOGOUT and the system 2 
ready for general operation. (See System Boot-Up Procedures.) | 


The following commands, in sequence, load the application software. (It is 
assumed that you are still logged in.) 


To Load Application Software 


n> ATTACH MT, TAPE } Mount the application tape 
marked CADDS.OVLY on the 
tape drive. : 
TAPO OF TYPE OF TAPE | Message indicates that tape is 
ATTACHED AS MT sucessfully attached. 


n> COPY:MT//NLEV [,LIST=NO] ) For no printout, use LIST=NO 
option; it suppresses all output 
except error messages. 


n> SYSCMTB CMTB.XXX ) Additional user applications must 
be initialized with this command. 
(XXX = Command Table name. 
See current Command Tables.) 


The system is now fully initialized and ready for users to Login. 


During the re-start (Boot-Up) process, load the O/S into the CGP-200 to 
initialize/COLDSTART the O/S. The CGP-200’s Automatic Program Load 
(APL) automatically loads the O/S (from primary disc or tape devices) into 
the CGP memory. 
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Selecting 
Boot-Up Device 


CGP 200 Boot-Up 


Boot-up device information is presented in the table that follows. 


Typical APL Assignments Device Switches 
Disc - APL1 (left block) Each APL switch block contains seven 


Tape - APL2 (right block) miniature rocker switches (right side of 
control panel). 


Switch Function 
1 Controls whether the device is a DMA device (ON 
for all Boot-Up devices). 
2-7 Contains device code for desired device. 


Typical Device Configuration 


APL1 126 MSC 1300 Storage Module Controller (DPU). 
136 Telefile Storage Module Controller. 
APL2 122 Magnetic Tape. 


Two large black switches, STOP/RESET and APL1/APL2 located in the 
middle of the CGP control panel, initiate the Boot-Up. APL1 switch is nor- 
mally set for the primary disc’s device code; APL2 is normally set for the 
tape drive’s device code. 


e Press STOP/RESET switch Make sure primary disc is powered 
up and on-line. 


e Press APL1/APL2 switch 
to APL1 for a boot from 
primary disc. 


**CGOS 200/10 REV. 0.0** This message is displayed on system 
console. 


The system is now ready for operation. Other users can Login. If a hard- 
ware error occurs, type PC and ACCUMULATORS in this format: 


PC ACO AC1 AC2 AC3 
XXXXXX XXXKXX XXXXXX XXXXXX XXXXXX 


Save this information and notify appropriate CV field service personnel. 
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SAVCOR SAVCOR is used during system debugging to examine a snapshot picture | 
of core. SAVCOR saves all of the core, transfers it onto the disc, and 
reboots the system into core. The system is again ready for Login. 


e Press STOP. 

e Press RESET. 

¢ Examine location 2. 

© Select System Console. Set switch 14 down; reset switch 4 
and 5 to previous settings. 

e Continue 


The file manager determines the disc location of the SAVCOR buffer 
(where the last SAVCOR taken resides on the disc). 


DDEX Boot-Up Diagnostic Disc Executive (DDEX) is a mutually exclusive disc resident on 
the CGOS 200 GNA, i.e., both CGOS 200 and DDEX may simultaneously 
reside on the system primary volume. 


¢ Set console switch 0 Follow CGP boot-up procedure 
outlined above. 


**CGOS 200/ Rev 0.0** Message appears if DDEX is not on © 

NO DDEX BOOTSTRAP ON DISC. disc. When DDEX is on disc, this © 
message is followed by DDEX Boot- 
Up message. 


You are now running under DDEX. You may return to CGOS 200 GNA by 
rebooting the system with console switch 0 off. 
Note 
DDEX Is also invoked by typing the BOOTDEX 


command at system level. See BOOTDDEX 
command documentation, Section 8. 
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n> LOGOUT ) Enter command. 


MINS. ELASPED: COST: When authorized Login or account- 
ting Login is enabled, the system 
responds with the time elapsed since 
Login and the cost for time used. 


**TASKn TERMINATED** This is the final system response in all 
configurations. 


All units attached to the task are 
released and the task ts terminated. 


The System Manager can, optionally, set the Autologout feature at 
BLDSYS time. If set to off, user tasks are only logged out when the 
LOGOUT command is entered. If set to on, the system logs out tasks per- 
mitted to remain idle for 15 minutes at system level. 
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Section 4 


SYSTEM FAILURES/RECOVERY PROCEDURES 


HARDWARE 
FAILURES 


SOFTWARE 
FAILURES 


This section describes hardware errors, software errors, and crash recovery 
procedures. 


Disc hardware failures may be: 


e Reported by the CHKDISC command. 
e Implied when sectors on the disc pack become physically unreadable. 


¢ Indicated by the DUMPERR command's F006 errors showing ACO = 
124x. 


Portions of data may be saved on tape, directly from the failed disc (de- 
pending upon the occurrence of unreadable sectors). If no software 
failures have occurred, this data should be valid. To ensure its future 
reliability, saved data should be verified before/after saving, and before 
attempting to use it in the production mode. 


Disc software failures are indicated by: 


e Unexplainable file manager errors, etc. 


e Hardware errors; i.e., FOO6 errors where ACO = 1nn, hexadecimal 
(1 = disc; nn = value other than 24, where 24 = disc offline or hardware 
disc error). 


— F006 is a general device hardware and device software error code. 


— ACO points out the device where the error occurred. ACO’s left 
byte indicates the device the error is concerned with; ACO’s right 
byte tells the type of error (either hardware or software). 


Rather than particular sectors being unreadable, the sector’s data content 


has become invalid. Failures result when the software attempts to make 
use of this invalid data. 
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When the software fails, no data should be saved from the failed pack 


(data problems are usually subtle and widespread when symptoms appear 


at the user level.) If a pack must be saved on tape, data should be carefully 
validated before saving for future use. CV can make no assurances of the 
data’s reliability. 


Note 


To report software failures refer to BUG 
REPORTING in Section 1. 


When recovery options are complete, the storage module must be refor- 
matted and rebuilt (see Section 2). Following FMINIT, CHKDISC verifies 
the storage module’s usability. Data from back-up tapes may now be 
restored. 


Caution 


Storage modules that have experienced head 
crashes are IRRECOVERABLE; They should 
NOT be remounted in any drive until repaired 
and inspected. 


CGOS 200 GNA constantly monitors system memory modules for hard- 
ware failure. Should any part of the system memory fail, the system 
automatically shuts down and this message is output to the System Boot- 
Up Console. | 


MEMORY INTERRUPT[, PRESS CONTINUE] 

e Set console switch 8 
With switch set (normal mode of operation is to have have switch 8 
off), the optional portion of the message “PRESS CONTINUE” 
‘appears. : 
Switch 8: Halts the system during memory diagnostics, and allows CV 


field personnel to examine memory boards for memory parity error 
indicator lights. 


Memory Parity 
Errors 
(Continued) 


CRASH 
RECOVERY 
PROCEDURE 


To Login 
After System 
Crash 
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e Press CONT on CGP Console 


Resumes diagnostic procedure. If switch 8 is off, the system executes 
diagnostic procedure without halting; when completed, one of these 
messages is emitted: 


1. 


TRANSIENT 


Transient Error. System received a memory parity interrupt but 
was unable to repeat the error. 


RECOVERABLE AT XXXX YYYY 


Recoverable Error. System received repeatable parity interrupt 
and was able to clear the error by writing to the bad location. 


(XXXX = 2K module hex value where error detected.) (YYYY 2K 
module hex value offset within 2K module.) 


NON-RECOVERABLE AT XXXX YYYY WWWW RRRR 


Non-Recoverable. System received repeatable parity interrupt but 
was unable to clear error by writing to the bad location. 


XXXX and YYYY values same as above. 
WWWW = pattern written to cause error. 
RRRR = pattern read back. 


When memory parity errors occur, system integrity is no longer 
assured. Save all information output to the system console and notify 
the CV Regional Office immediately. When the hardware problem is 
corrected, or another system is available, the pack may be recovered. 
(See Crash Recovery Procedure that follows.) 


This message, during Login, means that the system has crashed: 


SYSTEM ERROR FM ERROR IN ACCT OR ACT FILES: FILE MANAGEMENT 
DISABLED. DEFAULT SYSTEM MANAGER MUST LOGIN (DO NOT REBOOT) 
AND RUN FMRCVR AND FMCLEAR. | 


#(CTRL)-L Use name, number and the password 
TYPE NAME, NUMBER included on COLDSTART tape. 
CGOS 200,10 } 
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TYPE PASSWORD ) CGOS 200/10 with ) as password = 
CV default on all COLDSTART tapes 
(unless a COLDSTART tape has 
been created via GENSLTAP com- 
mand, and default Login entry is 
changed). See GENSLTAP (Section 


8). 

n> FMRCVR } Check user LOGIN MODES (Section 
3), then proceed with FMRCVR 
(Section 8). 

n> FMCLEAR })} See FMCLEAR (Section 8). 


If the above fails, the disc must be totally rebuilt; the file manager has been 
destroyed. , 


SYSTEM ERROR Current error codes and messages are listed in the CGOS 200 GNA 
CODES/ Operator Guide. The following table lists on-line filenames, the hex- 
MESSAGES adecimal range of the error codes, and the particular type of error. (VOTE: 
This information can be accessed by HELP.ERROR.) The last part of this | 
section explains how the user can change the content of error messages. _ 


On-Line Filenames and Error Message File Ranges 


Error File/Error Range Error Lines 
System SYSNEWS.ERROR.SYS System error codes/ 
Error (0301-FFO7) meanings. 

Device ACO Left byte specifies 

Errors device where error 

for occurred. 

FOO6x SYSNEWS.ERROR.FOO6DEV Left byte error code 
(0000-0011 — Devices) descriptions. 
SYSNEWS.ERROR.FOO6TYP Right byte descrip- 
(0001-0035 — Errors) tions. 

File | SYSNEWS.ERROR.FM File Management error 

Management (C0001-CFFF) descriptions. 

Errors 


ON-LINE 
FILENAMES 
AND ERROR 
MESSAGE 
FILE RANGES 
(Continued) 
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Error 


FUTIL 
Errors 


COMMANDS 


UTILITIES 


File/Error Range 


SYSNEWS.ERROR.FUTIL.RUNNERS 
(A000-A019 — !/O Handler) 

(A020-A024 — Disc) 

(A030-A031 — Paper Tape & Card Reader) 
(A040-A069 — Magnetic Tape) 
(A070-A093 — Miscellaneous) 


SYSNEWS.ERROR.FUTIL.SCANERRS 
SYSNEWS.ERROR.FILESCAN 
(A100-A114 — Utility) 

(A180-A1B2 — FUTIL Scanner) 


SYSNEWS.ERROR.EDIT 
(8001-8014) 


SYSNEWS.ERROR.LOADER.MAJOR 
(8001-8052) 


SYSNEWS.ERROR.LOADER.MINOR 
(8080-9092) 


SYSNEWS.ERROR.LOADER.DIAGNOSTICS 
(80D1-80D5) 


SYSNEWS.ERROR.SRCHBCD 
(8001-800B ) 


SYSNEWS.ERROR.TECO 
(8001-8FFF) 


SYSNEWS.ERROR.UTIL 
(9801-980A) 


Commands (EDIT, LOADER, TECO, etc.) have their own versions of error 
files. 8001 for Editor means one thing; 8001 for SRCHBCD means another. 
Each system command may have an error range of 8001 to 8FFF. 
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Changing Error 
Message Content 


Error messages can be adapted to meet special site requirements. The 
following printout illustrates the steps involved when error message con- 


tent is changed. 


s> EDITCMTB CMTB.FILE, N } 


**ERROR CALL C007** 
--FILE OR CATALOG ALREADY EXISTS 
(COPEN, RENAME) 


5> SRCHBCD SYSNEWS.ERROR//NLEV ) 


SRCHBCD SYSNEWS.ERROR//NLEV 
5-6-80 0:32:59 


#L, COO7 } 


SYSNEWS.ERROR.&BCD.FM 
5-6-80 0:05:07 


34! = = C007 


P | | 
5>EDIT SYSNEWS.ERROR.FM ) 


#734-39 | 

34! = = C007 

35!--FILE OR CATALOG ALREADY EXISTS 
36!(COPEN, RENAME) 

37! = = 

39! = = C008 

39!--ATTEMPT TO DELETE A NON-EMPTY CATALOG 
#R35-36 | 

--COULD NOT CREATE FILE OR CATALOG; 

--FILE OR CATALOG ALREADY EXISTS . 


#F ; 
s> EDITCMTB CMTB.FILE, N ) 


**ERROR CALL C007** | 
--COULD NOT CREATE FILE OR CATALOG; 
--FILE OR CATALOG ALREADY EXISTS — 


> 
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(Command causes 
error message. Part 
of which is to be 
replaced. ) 


Instruct the system 
to find the error 
message for C007. 


Type Search com- 
mand (locate for) 


C007. 


Line of text is given 
containing CQQ7; ter- 
minate with ESC-O 
when you get data. 


Use Editor to change 
message. 


Retype the original 
command; gets new 
error message. 


Describing 
Errors 
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The amount of information output to the user when an error occurs can be 
modified to suit particular needs. The SELECT command is used to specify 
one of three possible information levels, as shown. 


e Error number only: 
SELECT ERRLEVEL = SHORT 


e Error number and a brief description: 
SELECT ERRLEVEL = NORMAL 


e The error number, descriptive title, and detailed description: 
SELECT ERRLEVEL = LONG 
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Section 5 


DAY-TO-DAY OPERATING PROCEDURES 


BACK-UP TAPE 
MANAGEMENT 


Saving Files 


To Label Tapes 


This section consists of selected day-to-day operating procedures and 
computer printouts to illustrate examples. Users will be sent either revi- 
sions and/or change pages to future procedures. 


It is critical system back-up procedure immediately. From the first day of 
operation, start a system back-up procedure to save all (selected groups) 
of system files. File systems can then be quickly and easily restored with 
minimal losses, should a mishap occur. 


Have the operator run the FUTIL command or execute files (using FUTIL) 
to save files on magnetic tape. A full back-up is used to save all files; 
groups of files may be saved separately. Files that have changed since the 
last full back-up, are saved with what is called a save-since. 


Start a library of magnetic tapes from these back-up operations. Save each 
operation on a separate tape, identifying each tape by: 


e System name 

System number 

Revision date 

Type of save (full back-up, save-since) 
Tape density 

Tape number. 


On recycled save-since tapes, note (on an extra label) the date the last 
save-since was dumped. 


Examples 


SYSTEM GEORGE SYSTEM#3 


CADDS 4 rev 2.00 CADDS 4 rev 2.00 
6-June-79 Save-since 1600 BPI 
Full back-up 800 BPI Daily 
Tape File #3003 3-Jan-80 
(#3 of 6) 10-Jan-80 
17-Jan-80 
24-Jan-80 
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Tape 


_ Libraries 


DAILY /WEEKLY / 
MONTHLY 
PROCEDURES 
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For easy reference, keep a hardcopy list of tape filenames and a hardcopy _ 
listing of each full back-up. Requests to restore files can then be dealt with 
as follows: 


e Reference the binder containing the full back-up listing. 


e Record tape date; number(s); and file record number(s) of the files to 
be restored. 


¢ Have the operator restore the files using the FUTIL command. 


System back-up procedure depends on system use. A system with few 


catalogs that seldom change would be backed-up differently than a system 


that has many catalogs changing often. 
Procedure 1 


Daily 

Dump save-since tape. Daily save-since tapes can be recycled on a 
weekly basis (4 to 8 tapes rotating). 

Weekly 

Dump save-since tape (previous weekly save-since dumped). The weekly 
tapes are rotated on a monthly basis (16 to 32 tapes rotating). 
Monthly 


Perform a full back-up of system. Save all files on system; store in- 
definitely (4 to 10 tapes per month). 


Approximate tape usage for one year, 68 to 160. 
Procedure 2 


Daily 

Dump save-since tape of day’s work. Recycle these tapes on a weekly 
basis (4 to 8 tapes rotating). 

Weekly 


Dump a full back-up of system. Rotate tapes on a monthly basis (16 to 
40 ‘tapes rotating). a 
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DAILY /WEEKLY / 
MONTHLY 
PROCEDURES 
(Continued) 


SYSTEM 
REBUILDING 
PROCEDURES 


Monthly 

Save last full back-up. Rotate these monthly tapes on a six-month basis 
(24 to 84 tapes rotating every 6 months). 

At Six Month Intervals 


Save last monthly back-up for an indefinite period (8 to 16 tapes per 
year). 


Approximate tape usage for one year, 52 to 112. 


Procedure 3 


If all development or production work is performed in selected catalogs, 
it may be advantageous to perform the back-up procedure on only those 
catalogs. 

First 


Dump full back-up to create a baseline. 


Second 


Create an execute file to perform a daily full back-up on the selected 
groups of changing catalogs (5 to 10 tapes per week rotating). 


Weekly 
Save last daily full back-up. (4 to 8 tapes per month rotating). 


Monthly 


Dump a full back-up of entire system (24 to 48 tapes rotated every 6 
months). 


At Six Month Intervals 
Save last full back-up indefinitely (8 to 16 tapes per year). 


Procedures 1 and 2 


To COLDSTART and initialize the system, follow instructions in Sec- 
tion 3. 


Restore the latest version of a full back-up using FUTIL command 
(COPY[/LIST =NO] :MT : //REPLACE= YES). 


In sequence, from earliest to latest, restore any weekly save-sinces and 
then daily save-sinces until all tapes are restored. Use the FUTIL com- 
mand: (COPY[/LIST = NO] :MT : //REPLACE= YES). 
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Day-to-Day Operating Procedures 


SYSTEM 
REBUILDING 
PROCEDURES 
(Continued) 


TAPE USAGE 


SYSTEM 
BACK-UP 


PROCEDURES 


Full Back-Up 


Daily 
Save-since 


Selected 
Back-up 
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Procedure 3 


Restore the latest full back-up, followed by the latest of the 
selected catalog tapes using the FUTIL command: 
(COPY[/LIST =NO] :MT : //REPLACE= YES). 


Tape usage is dependent upon system usage. Any figures given represent 
approximations of standard usages with tape density set to 1600 BPI and a 
300 MB disc pack 75 percent full. 


Given below are examples of commands used in system back-ups. Full 
back-up, daily save-since, and daily selected back-up are all described. In 
all cases, the FUTIL command is used (see FUTIL, Section +, CGOS 200 
GNA Operator Guide). 


n>ATTACH MT, TAPE } 

n>FUTIL ) 
#COPY[/LIST =NO] : :MT//LABEL = /XXXXXX/ 
# ) 

n>DETACH MT ) 


On a daily basis, enter the following commands. (This can be done by — 
using an EXECUTE file.) Where SINCE =6-3-80:00:00:00 is specified, 
substitute the date (and optionally, the time) of the last daily or full back- 
up. 


n>ATTACH MT, TAPE ) 

n>FUTIL 
#COPY[/LIST = NO]//SINCE =6-3-80:00:00:00 : :MT//LABEL = /XXXXXXX/ 
# 
n>DETACH MT ) 


To back-up selected catalogs, use this sequence of commands: 


n>ATTACH MT, TAPE ) 

n>FUTIL } 
#¥COPY[/LIST = NO] catalog! :MT 
#ADD[/LIST = NO] catalog2 
#ADD[/LIST = NO] catalog3 


fADD[/LIST = NO] catalogn 
n>REWIND ) 
n>DETACH MT } 


SYSTEM 
START-UP AND 
SHUTDOWN 
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Start-up and shutdown procedures for various conditons are described in 
detail. 


System Shutdown « 


(End of Work 
Period) 


System Shutdown °« 


(Before Long 
Weekend or 
Plant Shutdown) 


Ensure that the main AC circuit breaker on the wall is in the OFF posi- 
tion. 


Ensure that all devices (CGP, Disc, magnetic tape units, etc.) are turned 
off. 


Turn on wall-mounted main AC circuit breaker. 
Power-up CGP (switches are located behind front and rear panels). 


Power-up disc, magnetic tape units, all terminals, and any other 
peripheral devices. 


Press RESET on CGP. 
Press START/STOP on disc drive. 


Remove disc from drive and put in dust cover. (Never place disc on top 
of disc drive.) 


Do not remove AC power from CGP. The AC power switches and circuit 
breakers are located behind the front and rear panels of the CGP and on 
the wall. 

Log-out all tasks. 

Press RESET on CGP. 

Power down all terminals. 

Press START/STOP on disc drive. 

Remove disc pack and store properly. 

Power down disc. (Front and rear panels must be removed.) 

Remove any magnetic tapes from mag tape unit and store properly. 
Power down magnetic tape unit and computer. 

Remove front panel from CGP and shut switch off. 


Turn main AC circuit breaker on wall to OFF. 
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System Shutdown 
(After Power 
Failure) 
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e Turn main AC circuit breaker on wall to OFF. 


e Power down each piece of equipment: CGP, magnetic tape unit, disc, 
etc. 


© Power down each terminal. 
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Section 6 


SPECIALIZED SYSTEM BUILDING PROCEDURES 


DEFINING 
SYSTEM 


This section defines system building procedures, multi-volume_ pro- 
cedures, and the Protection Facility. 


The customer-tailored configuration (slot 0) is rarely changed. New con- 
figurations are defined by selecting hardware components for system and 


CONFIGURATIONS software features after System Initialization. 


Configuration 
Dialogue 
Responses 


1. Execute appropriate command: 


¢ NEWCFG Generates new configuration; dialogue lists all 
definition tables. 


e EDITCFG Modifies configuration; select definition table via 
EDITCFG. 


e FUTIL Restores previously-saved configuration (tape). 


2. (For NEWCFG and EDITCFG only.) Dialogue Response heading 
defines configuration. | 


3. Execute BLDSYS command. 
When new configurations are defined, with either procedure (see Defining 
System Configurations), their definition tables are output in dialogue 
format. 
Configuration Dialogue 
) Indicates no selection or modifi- 
ation; procedure advances to 


next step. 


When _ selection required, } re- 
peats question. 
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Configuration TYPE PARAMETER NUMBER, 
Dialogue COMMA, NEW PARAMETER VALUE. 
Responses 

(Continued) 


TYPE COMMA N 
AFTER SELECTION. 


TYPE L IN PLACE OF OPTION 
SELECTION RESPONSE. 


TYPE L IN PLACE OF 
PARAMETER MODIFICATION 
RESPONSE. 


System Options CGP Parameters 


. TIS SIZE (HEX) = 
. FIOFLAGS (DEC) = 
. #TAPE REQ (DEC) = 
. #DISC REQ (DEC) = 
TASKS (DEC) = 
SWAP INDEX (DEC) = 
. BMS INDEX | = 
BMS INDEX B = 


=DOWMONOOAWND = 


at a), 


103 
4 
1 


. AUTOLOGOUT (ON =1/OFF=0) (DEC) 
. SITE-ID FOR THIS NODE (DEC) 
. CONNECTION CONFIGURATION (HEX) 


CGP without FPU Parameters 


1. TIS SIZE (HEX) = 
2. HIOFLAGS (DEC) 

3. #TAPE REQ (DEC) 
4. #DISC REQ (DEC) 
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0080 


O1 ND O1 


Modifies selection parameter. 


Parameter Input/Output Values 


(DEC) - decimal number. 

(HEX) - hexadecimal number. 

(BCD) - two BCD characters. 

(NC) -no change; parameter 
cannot be modified. 


N (no list), suppresses parameter 
listing which is otherwise 
automatically listed once per option 
selection. 


Prints option list if not auto- 
matically done. 


Modified parameter lists are not 
automatically printed. Type L here 
to verify completed parameter list. 


“BAD PARMS: n1,n2,...nk” is out- 
put, when invalid parameters are 
found. Re-input selection and 
parameters. 


il 
| 
oom 


0000 


System Options 
(Continued) 


Configuration 
Definition 
Table 
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. TASKS (DEC) = 1 
. SWAP INDEX (DEC) = 103 
. BMS INDEX | = 4 


1 


. AUTOLOGOUT (ON =1/OFF =0) (DEC) 


5 
6 
7 
8. BMS INDEX B 
9 
0. SITE-ID FOR THIS NODE (DEC) 
1 


Centaur Parameters 


. TIS SIZE (HEX) 

. FIOFLAGS (DEC) 

. #TAPE REQ (DEC) 

. #<DISC REQ (DEC) 

. TASKS (DEC) 

. SWAP INDEX (DEC) 
. BMS INDEX | 

. BMS INDEX B 


8 


-2aoc-anas 


. SITE-ID FOR THIS NODE (DEC) 


=—- O OAOAN OO HRWN — 


—_ =o 


. CONNECTION CONFIGURATION (HEX) 


. AUTOLOGOUT (ON = 1/OFF =0) (DEC) 


. CONNECTION CONFIGURATION (HEX) 


Hott Al 
| 
ash 


1 
—1 
0000 


Various definition tables are provided with guidelines for choosing 


parameters. 


General System Parameter 


Values 

TIS SIZE (HEX) = N 
#IOFLAGS (DEC) = N 
# TAPE REQ(DEC) = N 
# DISC REQ(DEC) = N 
SWAPPING INDEX 

BMS INDEX | 

BMS INDEX B 

TASKS (DEC) = N 


System Function 
Allocated Space 


(Task Input Stream SIZE) Characters 
typed or digitized ahead without any 
data loss (‘8’x <N <’100’x). 


lIOFLAGS per task: (1<N <10). 


Tape |!/O requests pending per tape 
unit. Controller per task: (1<N 
<5). 


Disc 1/O requests pending per disc. 
Controller per task: (1<N <5). 


Buffer management and swapper para- 
meters. 
Number of tasks. 


Specialized System Building Procedures 


Configuration 
Definition Table 
(Continued) 


SELECTING THE 
PRIMARY AND 
ADDITIONAL 
DISCS 


To Select the 
Primary Disc 
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General System Parameter System Function — 
Values Allocated Space 
AUTOLOGOUT = N 1 = AUTOLOGOUT feature is enabled. 


A task idle at system level for more than 
15 minutes is automatically logged out. 


0 = AUTOLOGOUT disabled. 


SITE ID FOR THIS NODE GNA configuration parameters See 
CONNECTION CONFIGURATION Selecting GNA configurations. 


You chose the primary disc that controls where system software resides. It 
becomes controller 0 in the system. 


Although disc parameters are not usually changed, you may reduce them 
in size when there is limited space in the system. To modify parameters: 
use the command, “ENTER PARM MOD:” 


DISC 0 OPTIONS: (1) DPU 
(2) TELEFILE 


e Enter Option Option DPU selected 
e 1 ) 


e Enter PARM MOD ) PRIMARY DISC PARAMETERS: 


(1) # DRIVES (DEC) 

(2) DEVNO (HEX) 

(3) # SECT/TRACK (DEC) 
(4) # SURFACES (DEC) 
(5) # CYLINDERS (DEC) 


toll 
mah 


no 
oo 
co) 


Multiple disc unit configurations (on the dual storage module) normally 
reside on the same controller. In this case, change parameter 1 to reflect 
the number of drives. 


Standard Parameter Values 


_ Drive Tape 1 2 3 4 5 
DPU 80 megabyte 1=4 16x 32 5 810 
DPU 300 megabyte 1=4 16x 32 19 810 
TELEFILE 80 megabyte 1=4 1Ex 32 5 810 
TELEFILE 300 megabyte 1=4  ~1Ex 32 19 810 


You may add additional disc controllers (with one or more units per con- 
troller) to the system. Number them consecutively, starting with one. 


To Select 
Additional 
Discs 


SELECTING THE 
TAPE UNIT 


Standard 
Tape 0 
Options 
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DISC 1 OPTION: 


e Enter option 
1,N } 


e Enter PARM MOD 


2) 


Indicates Storage module is selected. 


Reflects 2 drives. 


A single unit tape controller resides in the system; additional tape units 
must be selected. These parameters may be set for the tape unit: 


NAME 1: 1st two characters of unique tape unit name. 
NAME 2: 2nd two characters of unique tape unit name. 
UNIT: The hardware unit number used by the controller to access 
this unit. 
UNCHWRDI,2,3: Unit characteristic words; values set at boot-up time. 
Note 


These parameters are currently not used by the 
system; only one type of tape unit exists (STAN- 


DARD). 


e Enter option 


1) 
e Enter PARM MOD ) 


a 

e Tape 1: 
1,N ) 

e Enter PARM MOD 
2,P1 } 
3,1 } 


eL) 


Ist tape unit selected. 


TAPE UNIT PARAMETERS: 


NAME 1(BCD) = TA TA 
NAME 2(BCD) = PO P1 
UNIT (DEC) = 0 1 
UNCHWRD 1 (HEX) = 0000 0000 
UNCHWRD 2 (HEX) = 0000 0000 
UNCHWRD 3 (HEX) = 0000 0000 


Parameters unchanged. 
2nd tape unit selected; parameter 
listing suppressed. 


Parameter 2 = P1. 
Parameter 3 = 1. 


Ask for parameter listing. 
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SELECTING Auxiliary device units (terminals, plotters, etc.) are added to the system by 
AUXILIARY selecting the appropriate option when defining a configuration. There are 
UNIT OPTIONS 22 possible auxiliary unit selections: 


Auxiliary Unit 0 Options 


(1) TELETYPE (12) VARIAN 216 
(2) INFOTON (13) TBIO 
(3) LINE PRINTER (14) GOULD 5100 
(4) TERMINET (15) GOULD 4800 
(5) 10S (16) INSTAVIEW 
(6) NUMERIDEX (17) GPU 
(7) VERSATEC (18) VARIAN 208 
(8) CARD READER (19) PCUC 
(9) XYNETICS C65 (20) PCUG 
(10) PAPER TAPE READER (21) CALCOMP 960 
(11) PAPER TAPE PUNCH (22) XYNETICS C84 


When an auxiliary unit option is selected, the default parameters for that 
option are typed. Parameters will include one or more of the following: 


Auxiliary Unit Parameter Selections 


NAME 1: 
NAME 2: 
DEVNO: 
DEVNO IN: 
DEVNO OUT: 
DEVNO n: 
BS PAD: 

LF PAD: 

FF PAD: 

CR PAD: 

LC SWITCH: 


TOP MARGIN: 
BOTTOM MARGIN: 
PAGE LENGTH: 
PAGE WIDTH: 
UNCHWRDn: 


1st two characters of unique name. 

2nd two characters of unique name. 

Device code. 

Input device code. 

Output device code. 

Nth device code (0 < n < 5). 

Pad characters required for backspace. 

Pad characters required for line feed. 

Pad characters required for form feed. 

Pad characters required for }. 

Indicates if the device has lower case alphabetic 
capability. Should be 20 (HEX) if device does not have 
lower case, 0 if it does. 

Skip n lines from top of page. 

Skip n lines at bottom of page. 

Text lines per page. 

Columns per page. 

Nth Unit Characteristics Word (0 < n < 4). 


Note 


TOP MARGIN, BOTTOM MARGIN, plus PAGE 
LENGTH gives the total lines per page (see - 
Section 2). 


SELECTING 
AUXILIARY 
UNIT OPTIONS 
(Continued) 


BISYNC 
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Default parameters may now be modified (see Defining System Configura- 
tions). When parameter modification is complete, and no default HARDEV 
is configured, this message is output: 


© TYPE OK IF DEFAULT HARDEV Causes unit being configured to be 
assigned as default HARDEV. 


(One default HARDEV allowed per 
configuration. ) 


To configure devices, refer to auxiliary parameter rules and guidelines. 
Specific auxiliary unit configurations are outlined in the following sections. 


In order to run the BISYNC Communications Package (IBM 2780), the 
system must contain a synchronous line unit (SLU) board for 
communications-based version of the IBM 2780 remote job entry terminal. 
(For additional information, refer to table that follows.) The SLU must be 
connected to a CV-supplied front-end Data Communications Processor 
(DCP). (A PCU-based version is described under CV2780.) 


BISYNC Configuration 


(for SLU Board) 
Device Task-based I/O 
Type (TBIO) 
Device DCPO 
Name 
UNCHWRDs Override default system para- 
meters for error recovery, line 
handling, etc. 
Word 1 
Digit 1 (left): Maximum line bids per try. (range 3-F). 
Digit 2: Maximum error retries per message. (range 3-F). | 
Digit 3: Maximum logical records per physical message. (range | 
1-4). 
Word 3 
Bit 0 (right): | 1=disable WAK message transmission. 
Bit 1: disable optional STX. 
Bit 2: enable full duplex modem control. 
Bit 3: disable abort on too many NAKs or ENQs when receiving. 


Any values outside the acceptable range are ignored. 
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WAK/ENQ — The DCP transmits WAK when it has received data and 
is not ready for the next data message within two seconds. When WAK 
transmission is disabled, the host detects the missing reply and sends an 
ENQ. The DCP replies when the next buffer is available. If no buffer 
becomes available within 20 seconds, the DCP assumes the system has 
died, and sends an EOT to the host to abort the reception. (Some host 
systems do not accept WAKs gracefully.) 


STX — (Optional, normally enabled.) STX refers only to multiple record 
text. When enabled, all records in a message begin with STX. When 
disabled, only the first record begins with STX. 


RTS — (Request-to-Send Line) Full-duplex modem control refers to the 
RTS line from SLU to modem. When full-duplex control is enabled, RTS 
is always up. When disabled, RTS is up only when transmitting. Half- 
duplex modems run with this feature off; full-duplex modems use this 
feature. The default is half-duplex. 


NAK-ENQ Abort — This results from an over-transmission of NAKs or 
overreception of ENQs while receiving data from the host. Some hosts 
do not abort reception; the protocol specifies the transmitting station 
responsible for errors, and the DCP aborts. 


EBCDIC — Host sites consider: the remote line declared, the EBCDIC 
Transparency feature enabled, and use of the Multiple Record feature 
optional. 


The following table lists default characters. 


BISYNC Default Characteristics 
3310 0000 0000 


Maximum line bids =- is 
Maximum retries = 3 
Records per block = | 
WAK transmission = enabled 
Optional STX = enabled 
Full-duplex modem control = _ disabled 
NAK-ENQ abort = enabled 


Example 


A system using a full-duplex modem, needing up to 8 line bids, 14 retries, 
and maximum records/block would use: 


8SE40 0000 0004 


HASP, CV2780, 
and CVNET 


Instaview, 
instaview-C 
Instaview-D, 
and CVD-4 
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The full-version HASP emulates an IBM HASP Workstation. Its two-way, 
interleaved communication with a host computer supports the HASP pro- 
tocol. CV's HASP uses the PCU as a front-end processor. The HASP’s 
PCU is configured identically to the CV2780 PCU, except that HASP 
ignores the unit characteristic words. 


Computervision’s CV2780 package is a PCU-based emulation of the IBM 
2780 remote job entry (RJE) terminal. Two of the three device code pairs 
(data channel ports) on the PCU must be enabled at installation and con- 
figured as shown. 


CVNET is a communications method allowing transmission of files and 
operator messages from one Computervision system to another. CVNET 
may be either SLU or PCU-based. If a PCU is used, two of the three PCU 
device-code pairs (data channel ports) must be configured. See table that 


follows. 
CV2780, CVNET Configurations 
CV2780 CV2780 CVNET 
SLU PCU PCU 
Device 
Type TBIO PCUC PCUG 
Device 
Name User-selectable PCx0 PCx1 
CVNX = default 
X = ordinal x = PCU board ordinal. 
CVNET SLU: 1st PCU = PCOO, PCO1; 
CVNO,CVN1,CVN2... 2nd PCU = PC10, PC11... 
UNCHWRD’'s Ignored Ignored Ignored 


All of these devices are configured by selecting auxiliary unit option 16. 
The default parameters for that option are: 


1. NAME1 (BCD) = VG 
2. NAME2 (BCD) = UO 
3. DEVNO 1 (HEX) = 0030 
4.DEVNO 1 (HEX) = 0031 
9. DEVNO 1 (HEX) = 0032 
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Instaview, 6. DEVNO 1 (HEX) = 0033 
Instaview-C, 7. UNCHWRD1 (HEX) = 0000 
Instaview-D, 8. UNCHWRD2 (HEX) = 0000 
and CVD-4 9. UNCHWRD3 (HEX) = 0001 - 
(Continued) 


The device unique names must be assigned sequentially (VGU0, VGU1, 
VGU2....) 


The first Unit Characteristic Word is used to distinguish among these 
devices. When bit 15 is set, it indicates that graphics are disabled. Only the 
CVD-4 should have that bit set. When bit 14 is set, it indicates that an 
Instaview-D surface is being used in place of the standard Instaview tablet. 
Thus, both the Instaview-D and the CVD-4 should have that bit set. To 


summarize: 

Device UNCHWAD1 
Instaview 0000 
Instaview-C 0000 
Instaview-D 0002 
CVD-4 0003 


The third Unit Characteristic Word is used to indicate the number of 
physical VGU boards configured with the device. For example, an 
Instaview-C, which is configured with 3 VGU boards, would have a 3 in the 
third UNCHWRD. 


Compucircuit, The Calcomp 7000 on-line plotter system consists of a Calcomp 748 plotter 
Calcomp 7000 — with a Calcomp 925 controller. Compucircuit is a photoplotter Device 
and Gerber manufactured by Computervision. Gerber is another compatible on-line 
Plotters plotter system. 


Calcomp, Compucircuit, and Gerber Configurations 


Calcomp 7000 Compueircuit Gerber 
Device 
Type C925 INFO TBIO 
Device 
Name C925 User-selected GP 
UNCHWRD’'s Ignored Only 1st Ignored 


UNCHWRD used 
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Compucircuit, Compucircuit UNCHWRD 7 Values 
Calcomp 7000 
and Gerber UNCHWRD Resolution 
Plotters Value Device (acc = accurate) 
wConmmnued) 0404 150 Compucircuit 1 mil 
0604 150 Compucircuit 1/4 mil 
0504 150 Compucircuit 1 mil, acc origin 
0704 150 Compucircuit 1/4 mil, acc origin 
0804 100 Compucircuit 1 mil 
0A04 100 Compucircuit 1/4 mil 
0904 100 Compucircuit 1 mil, acc origin 
0B04 100 Compucircuit 1/4 mil, acc origin 


These values are computed as combinations of the various bit values 
presented in the following table. 


Compucircuit Bit Code for UNCHWRD1 


Bit Hex Value Use 

0 0001 Reserved 

1 0002 Reserved 

2 0004 Unit = Compucircuit 

3 0008 Reserved 

4 0010 Reserved 

5 0020 Reserved 

6 0040 Reserved 

7 0080 Reserved 

8 0100 Compucircuit acc origin 

9 0200 Compucircuit resolution (0 = 1 mil, 1/4 = mil) 
10 0400 Compucircuit 150 (24” x 24’) 
11 0800 Compucircuit 100 (15’’ x 15’’) 
12 1000 Reserved 
13 2000 Reserved 
14 4000 Reserved 


15 8000 Reserved 
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Selecting auxiliary unit options 7 (Versatec), 12 (Varian 216), or 18 (Varian 
208), will cause the default parameters shown in table that follows to be 


Varian and Versatec Default Parameters 


typed. 
Parameter Versatec 

1. NAME1 VS 

2. NAME2 TO 

3. DEVNO 001F 
4. UNCHWRD1 0370 
5. UNCHWRD2 00C8 
6. UNCHRRD3 1B80 


Varian 216 Varian 208 
VR VR 
60 80 
001F 001F 
00C7 00C7 
00C8 00C8 
10B0 1080 


If a specific option is selected more than once, unique names should be 
assigned sequentially (e.g., VSTO, VST1, VST2). The device code for the 
unit is hardware configuration dependent. Unit Characteristic Words (see 
tables that follow) are used to indicate this model-specific information. 


Changing Printer/Plotter UNCHWRDS 


Format 


Characters/line 


~ Rasters/inch 


Rasters/line 


Specified By 


Ist UNCHWRD 
2nd UNCHWRD 
3rd UNCHWRD 
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Varian and Printer/Plotter UNCHWRDS 

Versatec 

Dot Matrix Printer Plotter UNCHWAD 17 UNCHWARD 2 

Printer /Plotters 

(Continued) Varian 
4108 0050 0064 
4208 0050 00C8 
4111 0084 0064 
4211 0084 00C8 
4115 008D 0064 
4215 008D 00C8 
4122 00C8 0064 
4222 — 00C7 00C8 

Versatec 

1200 0084 00C8 
8122 0108 0064 
8222 0210 00C8 
8124 0120 0064 
8224 © 0240 00C8 
8136 01B8 0064 
8236 0370 00C8 
8142 0200 ~ 0064 
8242 0400 00C8 
8172 0380 0064 


UNCHWRD 3 


0320 
0640 


0420 
0840 


0580 
OBO0 


0840 
1080 


0840 


0840 
1080 


0900 
1200 


ODCO 
1B80 


1000 
2000 


1C00 
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Gould Dot Refer to tables that follow for model specific information. 
Matrix 
Printer /Plotter 


Gould Configurations 


Gould 5100 Gould 5100 Gould 4800 


Plotter Printer Printer 

Device 
Type TBIO G51P G48P 
Device Assigned 
Names © consecutively: 

DMX0, DMX1, 

DMX2. 
UNCHWRDs 1st left digit of No input 

Ist UNCHWRD = 2. necessary. 


Gould Printer/Plottter UNCHWRDS 


Printer/Plotter  UNCHWRD1 = UNCHWRD2  ~ UNCHWRD3 


Gould 5100 2108 | 0064 0840 
(22’ plotter 
only) 
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Honeywell GRTS | 
and ISBD GRTS 


Univac 1004 
Synchronous 
and UT200 


The Honeywell communication package (GRTS) allows inter- 


communication with Honeywell 6000 series computers. The ISBD GRTS, 


a varient of the Honeywell GRTS, is configured identically to the 
Honeywell SLU as shown in table that follows. 


Honeywell GRTS Honeywell —ISBD GRTS 
____ PCU ‘SLU SLU 
PortO — Port 1 
- Device | 
Type PCUC TBIO TBIO TBIO 
Device | 
Name PCOO SYNO SYNO SYNO 
-UNCHWRDs Ignored Ignored Ignored 


Ignored 


The 1004 communication package allows synchronous communication 
with the Univac 1108 computers. 


~ The UT200 emulates a Control Data Corporation User Terminal 200 RJE 


workstation. Univac and UT200 communication via SLU and PCU, respec- 
tively, are configured as follows: 


Univac 1004 and UT200 Configurations 


Univac 1104 UT200 
~PCU SLU PCU SLU 
Device 
Type PCUC TBIO PCUC TBIO 
Device 
Name PCO0O SYNC PCOO SYNC 
UNCHWRDS Ignored Ignored Ignored Ignored 
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- Only the first word is used; it is bit encoded. These tables show bit en- 
coding and commonly-used UNCHWARDs, respectively. |OSB devices 
should be defined (for configurations) before any other devices. 


10 & 11 


12 


13 


14 
15 


IOSB Bit Code 


Hex Value © 


_ Device 


Display 

Plotter 

LTD 1 

CVD 

Display telewriter 
Plotter telewriter 

LTD 1 telewriter 
CVD telewriter 
Reserved 

Reserved 

1 Pen 

2 Pens 

3 Pens 

4 Pens 

Interact II 

Interact IV 

2 mil plotter resolution 
1 mil plotter resolution 
Display is 10 inches 
Display is 19 inches 


Specialized System Building Procedures 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


lIOSB The following table lists |OSB UNCHWRDs. 
(Continued) 


IOSB Unit Characteristic Words (UNCHWRDS) 


UNCHWRD Device 

lOS DISPLAYS 
4011 10” display and telewriter 
8011 19” display and telewriter 

lOS PLOTTERS Pens Resolution 
0022 Interact II, telewriter 2 mil 
1022 Interact IV, telewriter 1 2 mil 
1422 Interact IV, telewriter 2 2 mil 
1822 Interact IV, telewriter 3 2 mil 
1C22 Interact IV, telewriter 4 2 mil 
3022 Interact IV, telewriter 1 1 mil 
3422 Interact IV, telewriter 2 1 mil 
3822 Interact IV, telewriter 
3C22 Interact IV, telewriter 4 1 mil 


lOS DIGITIZERS 


0004 LTD only 

0044 LTD and telewriter 

0008 CVD only 

0088 CVD and telewriter 
DCMN If FUTIL or CONVERT is used, the values are: 


Card Reader 
UNCHWRD =0 — IBMO029 punch codes 
UNCHWRD = 1 — IBM026 punch codes 
UNCHWRD =2 — Special Livermore Tabs Card punch code 
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With the GENSLTAP command, you may duplicate the complete 
operating the configuration and CGOS software) on another tape. This 
should be done if the protection facility was enabled for added security. 
(See Section 3.) 


To Duplicate the O/S: 


n> ATTACH MT,TAPE ) 
n> GENSLTAP ) 


TYPE OK TO CHANGE DEFAULT LOGIN ENTRY 


OK ) 


TYPE NAME, NUMBER 
Name, Number } 


TYPE PASSWORD 
Password } 


The tape may later be loaded as if it were the original COLDSTART tape. 
When the configuration is defined, you may save it from disc onto tape for 
later use. (The configuration, not the O/S software will be saved.) It 
should be saved in a file-the filename identifying the configuration; it is less 
likely other users will overwrite it. 
To Save Configurations: 

n> COPYCFG Slotn, Filename } 

n> COPY Filename :MT } 
To Re-define Existing Configurations: 
You can use a previously-saved configuration to re-define an existing con- 
figuration when the O/S is already initialized. After mounting tape and 


attaching the tape drive: 


n> COPY :MT filename ) 
n> BLDSYS Filename } 


DUPLICATING 
THE O/S AND 
CONFIGURA- 
TIONS 
(Continued) 


BLDSYS 
Printout 
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TYPE OK TO SUPPRESS PRINT 


OK } 


TYPE OK TO USE NEW SYSTEM 
OK ) 


**** CGOS 200 REV 0.0 **** 


A ) in response to TYPE OK TO SUPPRESS PRINT message (during the 
BLDSYS procedure) prints out the information given below. The bulk of 
this information is not of use to the general user, and can be suppressed at 
BLDSYS time. The printout lists options and space used for generating the 
system configuration. 


TYPE OK } TO SUPPRESS PRINT 


ALLOCATE GLOBALS OF VARIABLE SIZE 


TAPEQ 0026, 6A79 (K1) 
CPUQO 000D, OF42 (SO) 
CPUQ1 000D, 0E35 (SO) 
CPUQ2 000D, 0E28 (SO) 
CPUQ3 000D, 0E1B (SO) 
CPUQ4 000D, OEOE (SO) 


DMANO 000D, 0E01 (SO) 
DRWBQ 000D, ODF4 (SO) 
DISCO OOF5, 6984 (K1) 
PTSKLIST 0009, ODEB (SO) 
DRSOURCE 0009, 697B (K1) 
DISCUNS 0001, ODEA (SO) 
RESTRDSC 0001, ODE9 (SO) 
DTWTCT 0008, ODE1 (SO) 
DMPTSPT2 004F, 692C (K1) 


CREATE CFG. DEPENDENT DATA STRUCTURES 
& LOAD CFG.DEPENDENT CODE 


SYS OPT 1/TASK 0: 

TIS 0080, 68AC (K1) 
lIOFLAGS 0008, 68A4 (K1) 
DATA 0690, 0100, 0041, 6863 (K1) 
DATA O68F, 0100, 003F, ODA2 (SO) 


TASK 1: 
TIS 0080, 67E3 (K1) 
IOFLAGS 0008, 67DB (K1) 


DATA 0690, 0100, 0041 679A (K1) 
DATA - O68F, 0100, O03F, ODE63 (SO) 


TASK 2: 
TIS 0080, 671A (K1) 
IOFLAGS 0008, 6712 (K1) 


DATA 0690, 0100, 0041, 66D1 (K1) 
DATA O68F, 0100, 003F, 0D24 (SO) 


TASK 3: 
TIS 0080, 6651 (K1) 
lIOFLAGS 0008, 6649 (K1) 


DATA 0690, 0100, 0041, 6608 (K1) 
DATA O68F, 0100, 003F, OCES5 (SO) 
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BLDSYS TASK 4: 
out IOFLAGS 0008, 6580 (K1) 
(Continued) DATA _0690, 0100, 0041, 653F (K1) 
DATA _068F, 0100, 003F, OCA6 (SO) 

TASK 5: 
TIS 0080, 64BF (K1) 
IOFLAGS 0008, 64B7 (K1) 


DATA 0690, 0100, 0041, 6476 (K1) 
DATA O68F, 0100, 003F, OC67 (SO) 


TASK 6: 
TIS 0080, 63F6 (K1) 
lIOFLAGS 0008, 63EE (K1) 


DATA 0690, 0100, 0041, 63AD (K1) 
DATA 0O68F, 0100, 003F, 0C28 (SO) 


TASK 7: 
TIS 0080, 632D (K1) 
IOFLAGS 0008, 6325 (K1) 


DATA 0690, 0100, 0041, 62E4 (K1) 
DATA O68F, 0100, 003F, OBDO (S3) 


DISC 0 OPT 2: 

CODE 0639, 0200, 00C8, 621C (K1) 
CODE 0633, 0100, 0021, OO3F (B2) 
CODE 0634, 0200, OOEC, 6130 (K1) 
DATA 0640, 0100, O00C, 77F4 (D4) 
DATA 063F, 0100, O003C, 0B94 (S3) 


TAPE 0 OPT 1: 
DATA O6DA, 0100, 0048, 60E8 (K1) 


AUX0 OPT 2: 

CODE 064C, 0100, 0008, 0C20 (SO) 
CODE 0648, 0100, 0016, 60D2 (K1) 
DATA 0672, 0100, 0006, 60CC (K1) 
DATA 0670, 0100, 0022, 60AA (K1) 
DATA 0671, 0100, 0033, 6077 (K1) 


AUX 1 OPT 2: 

DATA 0672, 0100, 0006, 6071 (K1) 
DATA 0670, 0100, 0022, 604F (K1) 
DATA 0671, 0100, 0033, 601C (K1) 


AUX 2 OPT 2: 

DATA 0672, 0100, 0006, 6016 (K1) 
DATA 0670, 0100, 0022, SFF4 (K1) 
DATA 0671, 0100, 0033, 5FC1 (K1) 


AUX3 OPT 2: 

DATA 0672, 0100, 0006, 5FBB (K1) 
DATA 0670, 0100, 0022, 5F99 (K1) 
DATA 0671, 0100, 0033, 5F66 (K1) 


AUX 4 OPT 2: 

DATA 0672, 0100, 0006, 5F60 (K1) 
DATA 0670, 0100, 0022, 5F3E (K1) 
DATA 0671, 0100, 0033, 5FOB (K1) 
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AUX 5 OPT 3: 


DATA 067D, 


DATA 0673, 


AUX 6 OPT 2: 

DATA 0672, 
DATA 0670, 
DATA 0671, 


AUX 7 OPT 2: 

DATA 0672, 
DATA 0670, 
DATA 0671, 
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0100, 
0100, 


0100, 
0100, 
0100, 


0100, 
0100, 
0100, 


WORDS AVAILABLE: 


0010 FROM 0C10 
0606 FROM 5800 
001F FROM 0020 
0500 FROM 0694 
07F4 FROM 7000 


TO 
TO 
TO 
TO 
TO 
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5F05 
5EBC 


5EB6 
5E94 
5E61 


5E5B 
5E39 
5E06 
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(K1) 
(K1) 


(K1) 
(K1) 
(K1) 


(K1) 
(K1) 
(K1) 


0C20 
5E06 
003F 
0B94 
77F4 
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THE PROTECTION The Protection Facility prevents unauthorized logins. It also protects files 
and commands by establishing the type of access permitted for each 
individual or group. (System level files refer to catalogs, parts, or text 
files.) This section covers the components, operation theory, and im- 
plementation of the Protection Facility. 


FACILITY 
(CONTROLLED 
USER ACCESS) 


A three-part control exists within the Protection Facility: (see figure that 
follows). 


1. 


To Login, the user inputs a name, number, and unique password that 
matches an entry contained in the Authorize File. The Authorize File, 
created with EDIT and AUTHRIZ commands, associates an access 
table and Default Protection Group (DPG) with each user. 


You may include an optional field, LOGIN TASK DIRECTORY 
FILENAME, after access table name and before the DPG. Up to 20 
characters, enclosed by single quotes (‘), this name forms the last level 
of a filename which is found in the catalog SYSTEM.DIRECTORY. 
(See AUTHRIZ documentation. ) 


Note 


In order to take advantage of GNA directory 
search rules, this feature must not be used. 


Any time a particular file or command ts accessed, the file or 
command's protection group (PG) and attempted type of access is 
compared to the PG and attributes listed in the user’s access table. An 
error message results if the PG’s listed attributes do not allow desired 
type of access. 


Users can create, modify, or restore files in any PG to which they have 
WRITE access. These files become a part of the user's DPG. The 
existing file’s PG is not changed when the file is modified. 
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Protection As System Manager, you design the protection facility with the FMINIT 
Facility command. The protection facility is initialized after the authorized Login 
Flowchart is enabled by the FMINIT process. 
HOW THE PROTECTION FACILITY FUNCTIONS 
START 
DOES 
USER ATTEMPTS COMMAND NO 
LOGIN BY REFERENCE 
CONTROL-L, A FILE? 
INPUTTING NAME, 
NUMBER, PASSWORD 
COMMAND 
YES EXECUTED 
ACCESS TABLE NO 
NO nena INCLUDE DESIRED ~ 
AUTHORIZE See is 
FILE? 
YES 
YES : 
COMMAND 
USER INPUTS EXECUTED 
COMMAND 
NO 


ALLOW EXECUTION 
FOR PG OF 
COMMAND? 


PROTECTION 


ERROR YES 
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Facility Access 


PROTECTION 
ACCESS 


PROTECTION 
GROUP (PG) 


ACCESS 
TABLE 
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The means of access, READ; DELETE; WRITE; MODEL (CADDS 4 only); 
OR EXECUTE. represented by a letter. With this letter, the user may 
access files and/or commands and [CHANGE] them to another protection 


group. 


The PG number is the number you give to a unique set of files/commands. 
It determines which users may access the files/commands. Files/ 
commands with the same number are said to be members of the same pro- 
tection group. Access types are attributes of the protection group, i.e., 
2500/R implies that the user has READ access for all files/commands in 
PG 2500 only. | 


An Access Table lists protection groups and their attributes (types of 
access). Each user is assigned to one access table which determines which 
files/commands the user may access. By adding full or part of the BASIC 
or ADMIN access table (template) to a user’s access table, you control 
his/her ability to execute specific commands and access specific files. 
(See the following tables. ) 


To Select Controlled Access: 


Access Table Types 


Access Used When Action 
BASIC Login restricted to users Step 1: See Authorize File. 
(Default access _ listed in Authorize File. 
tables BASIC 
and ADMIN Users have complete Step 2: See “‘Loading/ 
automatically access to most files/ Initialization of Applica- 
created by commands. Software’’. (Section 3) 
system) 
See Default Critical system commands/ 


Access Tables files restricted to a cer- 
tain group of users.* 


EXTENDED All of the above rquired. Step 1: See ‘‘Access Table 
(Tables created Design”. 
w/EDITACT) 

Restricted file/command Step 2: See “‘Authorize File’. 


access by selected user. 


Step 3: See ‘‘Loading/ 
Initializing of Application 
Software’’. (Section 3) 


“Critical commands: AUTHRIZ, BLDSYS, COPYDISC, FMINIT, FMRCVR, GENSLTAP, 
PACHDISC, PACHFIL, SET, SYSCMTB. Critical Files: Accounting and Protection files. 
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Default Protection 
Facility Access - 
Default Protection 
Group (DPG) 


DEFAULT 
DESIGNATORS 
(S,G,P) | 


As System Manager, you permanently assign the DPG in the authorize file 
to a user. When a user writes a file/command, his/her DPG is automat- 
ically assigned as the protection group of the file/command. You can 
temporarily change the DPG number with the SETPROT command. Each 
time the user logs in, his/her original number assigned becomes the DPG. 
Types of access are M=Model (CADDS 4 only), R=Read, W=Write, 
E = Execute command, C = Change PG of file/command, D = Delete. 


Default Access Tables 


Access Table Protection Group 
Name Range Attributes 
ADMIN 
1 0000 - 0000 / MRWECD 
2 0001 - 0001 / R 
3 0002 - 0002 / RWECD 
4 0003 - 0003 / RWECD 
5 0004 - 0010 / RWECD 
6 0011 - OOSF /E 
7 OOAO - 0O0A0 / RE 
8 OOA1 - 1FFF / RWECD 
9 2000 - 2000 / MRWECD 
BASIC , 
1 0000 - 0000 / MRWECD 
2 0010 - 0010 / RWD 
3 0020 - OO9F a= 
4 OOAO - 00A0 / RE 
5 OOA1 - 1FFF / RE 
5 2000 - 2000 / MRWECD 


The default designator (S-system, G-group, or P-private) plus the desired 
PG’s attributes are placed in an access table. When you specify the default 
designator and its accompanying attributes (with the SETPROT or 
CHGPROT command), the user may choose the associated PG without 
knowing the actual number. 


Example 
Access table SETPROT SRWD changes DPG 
to 2000. 
2000-2000/ RW 
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Protection Groups The following tables list system commands and associated protection 
0-0100 groups. Template refers to the default access table with which the user — 
may access file/commands. 


System Files 


Protection 
Group File/Catalog Template 
0 DATA — Computervision ADMIN/ 
Supplied Data Files BASIC 
2 SYSTEM.FAT — Access Tables ADMIN 
SYSTEM.&BCD.AUTHORIZE 
3 SYSTEM.LOG — Accounting Tables ADMIN 
10 SYSTEM — Basic system files ADMIN/ 
BASIC 
AO SYSCATLG — Primary System ADMIN/ 
BASIC 
Restriction 
All users must have SYSCATLG access to 
operate system, and RWD access to PG 10 to 
access basic system files. No user should have 
more than R access to PG 1. 
Restoring User- These special system files, used by the system protection facility, must 
Created Files have a protection group (PG) of 2: | 


e Access tables (SYSTEM.FAT.name). 
e System.&BCD.Authorize. 
e Authorized Login/Accounting Log Files (SYSTEM. LOG catalog). 
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The initial access tables and authorize file (created during FMINIT) have 
the correct PG. New access tables (created with the EDITACT command) 
always have the correct PG. However, any files restored from tape or 
copied from another file into the SYSTEM.FAT or SYSTEM.LOG catalog, 
may have the default protection group (DPG) of the user restoring the 
copy. These access tables are not usable by the system. 


To restore the correct PG, use the CHGPROT command after restoring 
new files into the catalog: 


¢ CHGPROT SYSTEM.FAT, 2 
e CHGPROT SYSTEM.LOG, 3 


In general, when a user wants to change access to a file, he/she must 
have: access to the old file, some access to the new file, and access to the 
CHGPROT command. 


System level commands are both CV-supplied and user-developed. The 


following commands, used in connection with the protection facility, are 
explained in detail in the CGOS 200 GNA Operator Guide. 


PG/System Commands 


Protection 
Group Commands Template 
10 AUTHRIZ FMINIT ADMIN 
COPYDISC FMRCVR 
EDITACT PACHDISC 
GENSLTAP 
OPLOG 
1F BLDSYS* ADMIN 
PACHFIL* 
SET 
20 CHGPROT DUMPKERN ADMIN/ 
CHKDISC LISTCFG* BASIC 
COMPILE LISTCMTB* 


*Indicates required user access to the file on which the command is per- 
formed. 
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Protection 
Facility 
Commands 
(Continued) 
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Protection 
Group 


30 


Commands Template 
COPY CFG* LISTLOAD 
CVTECO* LISTPROT 
DELCFG* LOAD* 
DUMP NEWCFG* 
RENAMDEV 
RENAM 
EDIT* SETPROT 
EDITCFG* SETTAPE 
EDITCMTB* SORTCAT* 
CONVERT TAPETYPE 
CONVERTB 
FMCLEAR 
GENCOM* 
ATTACH LOGOUT ADMIN/ 
CHGDEVNO BASIC 
COMPARE* 
CROSSREF 
DATE 
DETACH PRINTLP 
DOFORM PRINT* 
DSABDEV 
DUMPERR REWIND 
DUMPTAPE 
ENABDEV SELECT 
SETDEV 
FILCOM SETPUNCH 
FPHEX SORTFILE* 
GENINDX 
GETPUNCH 
HARDEV STATUS 
SYSNEWS* 
HEXCALC 
HEXFP TEST 
LCLNEWS* UP 
LISTCOM 


*Indicates required user access to the file on which the command is per- 


formed. 
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Protection Protection 
Facility Group Commands Template 
Commands 
(Continued) 100 ATCHVOL FMCHECK* ADMIN/ 
COPYTEXT LIST* BASIC 
COPY* FUTIL* 
DSABVOL COPYTEXT* 
DTCHVOL SYSCMTB* 
EDITACT* 
ENABVOL USERCMTB* 
EXECUTE* 
Note 
Protection group is 0 when the uncontrolled 
Login mode isselected for all of the above. 
BRIEF AUTHRIZ — _ Checks entries, encodes passwords of edited authorize 
DESCRIPTION file w/EDIT command. 
OF FACILITY 
COMMANDS CHGPROT — _ Changes a file’s PG. 
EDITACT | — Commands editor to create, modify, or delete access 
tables. 
LIST — Lists file's PG when FULL option used. 
LISTPROT — Lists current user’s access table and DPG. 
SETPROT — Changes current user’s DPG, allowing files to be be 


accessed. by selective classes of operators. (WRITE 
access must exist for the desired DPG.) 


Note 


See also System Commands in Section 8. 


*Indicates required user access to the file on which the command is per- 
formed. 
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ACCESS 
TABLES 


express written consent of Computervision. 


Access tables are set up as follows: 


ACCESS TABLE NAME 


PROTECTION GROUP RANGE 
ACCESS TYPE (ATTRIBUTES) 
(MODEL.READ.WRITE, 
EXECUTE, CHANGE, DELETE) 
USER: TABLO 


1. 0000-0000/MRWECD 


Sample Access Tables 


USER: TABLO 


. 0000-0000/RWECD 
. 0020-0009/E 

. 0010-0010/RWD 

. OOAO0-2000/RE 

. 2001-2001/RE 

. 2002-2003/RWD 

. 200A-200A/E 

. 2010-201F/RWECD 


ON DOH WNH — 


USER: TABL1 


. 0000-0000/RWECD 
. 0020-0009/E 

. 0010-0010/RWD 

. 00A1-2000/RE 

. 2003-2004/RWD 

. 2005-2005/RE 

. 2020-202F /RWECD 


WO O11 WD = 


USER: TABL1 


OanN OOH WH — 


. 0000-000/RWECD 

. 0001-0001/R 

. 0002-0002/RWECD 

. 0003-0003/RWECD 

. 0004-0010/RWECD 

. 0011-009F/E 

. OOAO-1FFF/RWECD 

. 2000-2000/MRWECD 

. 2001-2001/MRWECDS 
. 2002-2004/MRWECD 

. 2005-2006/ MRWECDG 
. 2010-202E/MRWECD 

. 201F-2020/MRWECDP 
. 2021-202F/MRWECD 


Designing the 
Access Table 


ENTERING 
ACCESS TABLES 
(PREPARATION) 
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You attain extended protection by structuring access tables to permit 
varied access for file/command protection groups. Simplicity is important 
when designing a comprehensive protection facility. An example follows 
this procedure. 


1. 


Categorize present and prospective user files/commands by function, 
purpose, or project. (e.g., general usage execute files, keyfiles, etc.) 
assign the same PG to files/commands of each category. Assign con- 
tiguous PGs to categories likely to be accessed by the same groups of 
people. 


Group operators into classes or teams, according to the common 
types of files/commands they will use. Class size may be one or 
greater. Each class will be assigned its own access table. 


Determine categories of files/commands each class will be able to 
access. List PGs of those files/commands in the class's access table. 
Associate allowed access for each PG (Model — CADDS 4 only, 
Write, Read, Delete, Execute, or Change). 


Combine PGs with same attributes into a range iS g., 2001/RE 
becomes 2001-2002/RE, etc.). 


Assign each user to a Default Protection Group (DPG); enter the DPG 
number into the Authorize file, The DPG number must also appear as 
a PG number in the access table with a write attribute. Because it will 
be assigned as the user’s file/command PG number, it should rep- 
resent the PG most likely to be used. (The DPG can, however, be 
changed by SETPROT; the file/command’s PG can be changed by 
CHGPROT.) 


To eliminate memorization of actual PG numbers (for users frequently 
switching between DPGs), use default designators as the argument of 
SETPROT, (S, G, or P) with the attributes of the PG containing ‘“W” 
access which is to be an alternate DPG. If the default designator is 
placed within a range, the first PG is chosen. 


Note 


CHGPROT reguires Change access to be an 
attribute of the original and changed PG. 
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ENTERING S, G, or P each identifies a unique PG only when placed with a uniaue 
ACCESS TABLES combination of attributes: 
(PREPARATION) 
(Continued) Example 
2000-2000/RWDS PG 2000 identified 
3000-3000/RWDG PG 3000 identified 
3500-3500/RWDG Never 3500 


7. Toallow access to system files/commands, the PGs of the ADMIN or 
BASIC standard access table must be added. This is done during 
EDITACT. The ADMIN table is usually reserved for System 
Managers; the BASIC table is sufficient for general Operators. 

8. Use EDITACT command. 

9. Creation of the access tables is complete. 

Example 

The following samples are designed to illustrate the process of developing 

the access rights of a group of users. In this particular example, the group 

of users are: 

1. The Project Leader (PRJLDR) who has access to all files. 


2. Three users who make up a sub-group: 


e User 1 & 2 — Each has a private PG and share access to a set of 
PG's. 


e User 3 — He/she has a separate set of PG’s and, therefore, a 
separate set of files to access. 


Authorize File 


Access Pass- 

User No. Table DPG Word 
PROJLDR, 1, TABL2, 0000, PL 
USER1, Z, TABLO, 2010, A 
USER2, 2, TABLO, 2011, B 
USERS, 10, TABLET 2020, C 
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ENTERING The following table illustrates a typical scenario dealing with user access 
ACCESS TABLES assignments. Each line in the table is numbered and explained in the 
(PREPARATION) paragraphs that follow the table. 

(Continued) 


Sample User Actions and Related Access Types 


Action User de Type of File/Command Available 
Line User Performed DPG PROJLDR | USER1 | USER2 USER3 


1. | PROJLDR | Creates new RWECD 
file A 
PROJLDR | CHGPROT file A RWD 
USER3 Edits file A RWD 
PROJLDR | SETPROT S — 
RWECD 
5. | USER1 Edits file B None 
6. | USER3 Reads file B Protection 
error 
7. | PROJLDR | CHGPROT file B | RE 
GRWECD 
8. | USER3 CHGPROT file B 2005 Pro- RE 


2020 tection 
Error 


9, SETPROT 2010 Pro- — | | — 
2004 tection 
Error 


Types of Access 


= Read 

= Write 

Execute command 

Change PG of file/command 
= Delete 


0UOMSsSD 
II 


6-33 


Specialized System Building Procedures 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


ENTERING 1. Anewrfile, ‘‘A’”’ is created by PROJDR. PG for PROJDR is assigned as 
ACCESS TABLES file A’s PG. 

(PREPARATION) 

(Continued) 2. File A’s PG changed to 2004. PROJDR has required ‘’C’’ access to 


0000 and some access to 2004. 


3. A modified and refiled file/command retains the same PG, regardless 
of the DPG of the user who last modified the file. 


4. DPG 2001 is chosen by inputting the default designator ‘’S’’ and 
appropriate attributes. 


5. Error: No “‘W” access for PG 2001 in the user’s access table. 
6. Protection error: File B’s PG is not listed in user 3’s access table. 


7. PG 2005 referenced by inputting default designator ‘’G’’ and access 
attributtes. First group in range chosen. 


8. Tochange protection ‘‘C’’, user must have access to both original and 
desired PGs. 


9. To change DPG, user must have ‘‘W”’ access for desired group. 
Creating the The Authorize file is required, regardless of whether Basic or Extended 
Authorize File access protection is desired. The Authorize file contains entries that 
establish each user's: 
LOGIN name and password. 
Project designation. 
Access table. 
Default protection group (DPG). 


Authorize file entries are input via the EDIT command: 


EDIT SYSTEM.AUTHORIZE 
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Creating the To Develop Authorize File 
Authorize File 
(Continued) Command Description 
#\ Input the following entries, one line per user to be listed in 


the authorize file. Separate each entry with a comma and 
each line by a 8 . Two consecutive 8 complete the input; 
the prompt (’’#’’) appears. 


e User’s Name (Up to 20 alphanumeric 
characters.) 


e Project Designation (Up to 13 alphanumeric 
characters.) Name and project 
designation may be empty en- 
tries tf no accounting entries 
are being kept. (Four commas 
still required.) 


e Access Table Name (Up to 20 alphanumeric 
characters.) When BASIC 
access protection is desired, 
there is a choice of two access 
tables: 


ADMIN - Assigned to users 
performing some _ function 
related to the System 
Manager, or users needing to 
access restricted files and 
commands outlined in Appen- 
dix A. 


BASIC - Assigned to users 
performing general system 
operations. 


(For EXTENDED access pro- 
tection, any access table 
created with EDITACT may be 
named.) 


@ Login Task Directory (Up to 20 alphanumeric 


Filename characters; delimited by single 
quotes.) This field is optional. 
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Creating the Command Description 


Authorize File 
(Continued) e Default Protection 
Group (DPG) 


(Up to 4 numeric characters.) 
0000 for BASIC access pro- 
tection. Up to 8000x for 
EXTENDED access protection 
(if user has WRITE access for 
that PG). 


e Password (A string of up to 6 characters 
of any type.) 
Caution 

Do not lose the pass- 
word, it is irrecover- 
able. 

#T | Types out entire file. (Checks for accuracy.) 

#En Allows you to edit specified line number (n=line number). 

#F Files Authorize file. 


AUTHRIZ File checked for errors; password is encoded. 


LOGOUT (Also subsequent LOGIN) required to enable changes made 


above. 
Sample Authorize Files 


SYSTEMADMIN,0,ADMIN,0000,ADMIN 


PROJLDR,1,ADMIN,0030,ABC 
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User logs in with the name 
SYSTEMADMIN and the | 
number 0. SYSTEMADMIN 
has ADMIN for a password 
and access table with a 
DPG of 0000. 


The Project leader, logging 
in with * (* meaning that no 
account number is needed), 
is allowed to use any 
number. He/she uses the 
access table ADMIN with 
ABC as a password and a 
DPG of 0030. 


Specialized System Building Procedures 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


Creating the 
Authorize File 
(Continued) 


MULTI-VOLUME 
PROCEDURES 


Initializing 


Volumes 


The Primary 
Volume 


Configurations / 
Naming 


Accessing 
Volumes 


User U1 uses the access 
table BASIC with EFG as a 
password and a DPG of 
0000. He/she must log in 
with number 2. 


U1,2,BASIC,0000,EFG 


U2,*, BASIC,0000 User U2 requires no number 
or password to LOGIN. 
U2’s access table is BASIC. 


The DPG is 0000. 


CGOS 200 GNA is capable of supporting a number of auxiliary disc 
volumes. The volumes may be removed and transferred to another disc 
drive during system operation. 


FMINIT must be used to initialize the File Manager on each volume. When 
initialization is complete, however, the volume may be transferred without 
initializing it a second time. If volumes were initialized with the SINGLE 
option they must always be mounted on the same drives. Volumes may be 
initialized independently by inputing the volume’s drive number. 


The O/S (primary volume) is always indicated by drive number 0. 
Authorized LOGIN and accounting procedures may only be enabled on the 
primary volume, which must not be removed from the drive during system 
operation. 


Each volume, unless initialized with the SINGLE option, may have its own 
unique configuration, O/S (See COLDSTART), and file manager structure 


-(FMINIT). The auxiliary disc volume is named in the usual catalog 


representation, except that an asterisk (*) must precede the name (e.g., 
*VOLNAME.CAT1.CAT2. FILE). 


Each volume will be assigned the PG input during FMINIT. Files cannot 
span independent volumes. | 


Five commands are necessary to access a volume (see Selecting the 
Primary and Additional Discs). A volume must be enabled and associated 
to the system with the ENABVOL command. Only then may the user 
attach to the volume with ATCHVOL. 


When no longer required, the volume should be detached using the 
DTCHVOL command. Only when volumes are detached from all tasks and 
then disabled by a DSABVOL command can a volume be physically 
removed. 
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AUXILIARY DISC LIST Lists volumes as if they were catalogs. 

VOLUME 

ASSOCIATED STATUS Lists disc status information, including system configura- 
COMMANDS tion, system version, and file manager status. 


LOGOUT Automatically detaches volumes from task. 


WORKING The file management system supports user-defined search lists, called 

DIRECTORIES directories. A directory consists of a hierarchy of catalogs, called directory 
entries. Once a directory is enabled by a task, the File Manager uses the 
search list defined in the directory to resolve all user file references. 


A directory restricts the scope of the File Manager’s search for existing 
files; when the user references an existing file, the File Manager searches 
only those catalogs specified in the directory. Search order corresponds to 
the order of the files on the list. 


New files referenced by the user are always created in the catalog 
designated as the CREATE directory in the user’s current directory. A 
directory is automatically enabled at LOGIN time when a user’s directory 
command filename is specified in the SYSTEM.AUTHORIZE file. (See 
AUTHRIZ on-line documentation.) 

Example 

Entry is SYSTEMADMIN,0O,ADMIN,‘MYDIR’,PSW 

ENABDIR SYSTEM.DIRECTORY.MYDIR is done at LOGIN time. 

User logs in under ‘““CADDS 3”; there is a file called 
“SYSTEM.DIRECTORY.&BCD.CADDS30PER” 


which contains the text: 


SYSCATLG = L (Typical GNA 
[(0] = G directory.) 


This line exists in the ““SYSTEM.AUTHORIZE’ file: 
CADDS3,*,BASIC,’CADDS30PER’, Password 
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Directory Enable, 
Override, Disable, 


List 
DIRECTORY A user may create a directory by using the ENABDIR command (see 
ENABLE Command Section in the CGOS GNA 200 Operator Guide). Once enabled, 


all file references are made within the user’s directory. 
Example 


n> ENABDIR CATALGA,CATALGB=C ) Searchlist CATALGA 
CATALGB is created/en- 
abled (where CATALGB 
= user’s create directory). 
=L Local Create; =G 
Global Create; =C Local 
& Global Create. 


n> EDIT FILEB ) The system searches 
CATALGA for the file 
CATALGA.&BCD.FILEB. 
If file does not exist in 
CATALGA, CATALGB is 
searched. If file does not 
exist in CATALGB, the 
system responds: 


TYPE OK TO CREATE NEW FILE System creates the file 
OK } CATALGB.&BCD.FILEA. 
#TV Typing file header within 


editor invokes _ filename 
without directory entry. 


&BCD.FILEA 
03-21-81 21:00 
Note 


In both examples, directory is transparent to 
the user. 
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Prefixing a ‘“=” to any file reference will override the working directory for | 
a single command. 


Example: 


User’s directory = CATALGA CATALGB =C. (Files CATALGA.FILE and 
FILE exist in the system when directory is enabled.) 


n> PRINT FILE } Outputs the file CATALGA.FILE to the COMDEV. 
n> PRINT =FILE ) Outputs the file named &FILE. 

A user directory may be explicitly disabled by using the DSABDIR com- 
mand (see CGOS GNA 200 Operator Guide). A user's directory is implicitly 
disabled at LOGOUT. 


A user may list the current directory with the LISTDIR command (see 
CGOS GNA 200 Operator Guide). 
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Section 7 


GRAPHICS NETWORKING ARCHITECTURE (GNA) 


GRAPHICS 
NETWORKING 
ARCHITECTURE 
(GNA) 


System 
Management 


Operation 


PHYSICAL 
CONFIGURA- 
TIONS 


Graphics Networking Architecture (GNA) is a CV communications pro- 
tocol that links several Designer Systems in a single, more powerful unit. 
When CADDS 3 or CADDS 4 systems are networked with GNA, users 
have the advantage of sharing pooled system resources, without com- 
plications in command syntax. GNA has little or no impact on perfor- 
mance. 


For the System Manager, GNA offers several advantages: 


e Support for up to 48 on-line interactive graphics users, as if all 48 
users worked on a single system. 


e Support from one system to another during partial failure conditions. 


e Centralized data management, with a master library of CADDS parts 
and subfigure files, and new features such as data archiving. 


e Centralized user accounting. 


GNA integrates the activities of distinct CADDS 3 or CADDS 4 systems 
into a single, unified system. From the operator’s perspective, each system 
no longer has a distinct identity. In its place ts a large multi-processor con- 
figuration with the following characteristics: 


e A single, centrally located CADDS database accessible to every 
operator. 


e Transparent access to data, including files stored in the central 
CADDS database. 


The CGOS 200 GNA network connects two to seven CV Designer Systems 
in an integrated unit. These systems are tied together in a network con- 
figuration that includes a central host node which is linked to each of the 
other satellite nodes. This type of network is called a star configuration. 

The maximum star configuration consists of a host node with six satellites. 
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In the star configuration, satellite nodes communicate with the host node, 
but not with each other. Shared data resides at the host node; on com- 
mand, the host node distributes this data to satellite nodes via communica- 
tion links. Every node supports user-interactive graphic activities. 


MAINFRAME 
REMOTE 
HOST 
HOST 
NODE 


6 SATELLITE 
NODES 


<~———— 48 INTERACTIVE WORK STATIONS ———> 


= 
STATION 


48 USERS 


STAR CONFIGURATION 
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The host node consists of a CGP with floating point unit, memory manage- 
ment units, and main memory. The host node supports: 


_@ Up to four storage module disc drives (to support a shared database). 


¢ Two magnetic tape drives (for system generation, archiving, and 
back-up purposes). 


e Non-interactive peripherals (printers and plotters). 


e Up to ten user tasks. 


In a non-networking environment, one system supports eight interactive 
graphics tasks. The same system, functioning as the host node in a net- 
work configuration, supports one less interactive graphics task for each 
link to a satellite node. For example, if the host is linked to four satellites, 
then it can only support four interactive graphics tasks. 


A satellite node consists of a CGP with memory management units, main 
memory, and a floating point unit. Each satellite node supports: 
e Up to four disc drives (for accessing temporary and non-shared files). 
e A magnetic tape drive (for system generation and local back-up). 
e Interactive graphic devices (Instaviews, IOS terminals, and digitizers). 
e Non-interactive peripherals (dot matrix plotters, printers, etc.). 


e Up to nine user tasks. Eight of these can be interactive graphics tasks. 


Each network node has the following requirements: 


Designer |V or Designer |V-R CGP-100 (CADDS 3): 
e 56K words for operating system. 
e 26K words for network connection. 
e 26K words for user task. 

Designer IV or Designer [V-R CGP-200 (CADDS 4): 
e 208K words (minimum) for operating system. 


e 26K words for network connection. 
e 34K words for user task. 
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The system building procedure (BLDSYS) has been modified to accom- 
modate GNA. The appropriate BLDSYS configuration must be configured 
at each node. To do this, the physical configuration of the network must 
be known. 


Each network node is identified by a unique integer, called a S/te-/D. A 
function of the software, Site-IDs are user-assigned as integers (range 0-6) 
during system generation at each node. Conventions dictate that the host 
have a Site-ID of 0, and that satellite nodes be assigned values from 1 to 6. 
Before configuring each node, a physical configuration map of the net- 
work is generated, and Site-IDs assigned to each node. 


Node-to-node connections (point-to-point links) are supported at each end 
by a Programmable Communications Unit (PCU). The host node must 
have one PCU for each link to a satellite; satellite nodes must also have a 


~ PCU at their end of the link. 


Sample Map of a Network with Three Nodes 


HOST NODE 
SITE-ID 0 


SATELLITE NODE 2 
SITE-ID 2 


SATELLITE NODE 1 
SITE-ID 1 


NETWORK PCU 
LINKED TO 
HOST NODE 


NETWORK PCU 
LINKED TO 
HOST NODE 


Graphics Networking Architecture (GNA) 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


Establishing a 


Configuration 
BLDSYS System parameters in the BLDSYS procedure have been expanded to 
Parameters accommodate GNA. Two new parameters, numbers 10 and 11, have been 
added. 
CGP System Parameters 
(Default values, no network configured) 
1. TIS SIZE (HEX) = 0080 
2. # IOFLAGS (DEC) = 5 
3. # TAPE REQ (DEC) = 2 
4. # DISC REQ (DEC) = 5 
5. # TASKS (DEC) =e 
6. SWAP INDEX (DEC) = 103 
7. BMS INDEX | = 4 
8. BMS INDEX B = | 
9. AUTOLOGOUT (ON=1/OFF=0) (DEC) = 1 
10. SITE-ID FOR THIS NODE (DEC) = -1 
11. CONNECTION CONFIGURATION (HEX) = 0000 
GNA Parameters Parameters 10 and 11 define the network configuration. 


e Parameter 10 is the site-ID for the node. If no network is eonngured: 
the value is -1. Otherwise, the value is as follows: 


Naming Conventions for Systems 


System Name Site-/D 


Host Node 

Satellite Node 1 
Satellite Node 2 
Satellite Node 3 
Satellite Node 4 
Satellite Node 5 
Satellite Node 6 


Ooh WN — © 


e Parameter 11 


A hexidecimal word that defines the connection configuration and in- 
dicates network connections for the node. The default value (0000) in- 
dicates no network is configured. Parameter 11 ts a bit-oriented map 
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with one bit per possible network connection. Bits are numbered from 
0; bit 0 is the left-most bit. If the node is connected to node N, bit N of 
the word is set. A network may have 7 nodes maximum; only bits 0-6 
are used, bits 7-15 are ignored. The appropriate values are: 


PCU(s) Connected Bit Number(s) Value of 
To Node(s) #: Set: Parameter 17: 
0 0 8000 
1 1 4000 
1-2 1-2 6000 
1-2-3 1-2-3 7000 
1-2-3-4. 1-2-3-4 7800 
1-2-3-4-5 1-2-3-4-5 7C00 
1-2-3-4-5-6 1-2-3-4-5-6 7E00 
Note 


For a satellite node, Parameter 11 will always 
have the value of ‘8000’x. 


Example 
Shows standard system parameters for a network with two satellites. 
CGP System Parameters 


NODE 0 NODE 1 NODE 2. 


1. TIS SIZE (HEX) 0080 0080 0080 
2. # IOFLAGS (DEC) 5 5 5 
3. # TAPE REQ (DEC) 2 2 2 
4. # DISC REQ (DEC) 5 5 5 
5. # TASKS (DEC) 7 9 9 
6. SWAP INDEX (DEC) 103 

7. BMS INDEX | 4 

8. BMS INDEX B 1 

9. AUTOLOGOUT (ON=1 /OFF=0) (DEC) 1 1 1 
10. SITE-ID FOR THIS NODE (DEC) 0 1 2 
11. CONNECTION CONFIGURATION (HEX) 6000 8000 98000 


Note that the above examples highlight GNA parameters only. Other ( 
system parameters are set as described in preceding sections. 
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PCU Parameters 


PCUC 


In addition to system parameters, users must also configure appropriate 
PCU Auxiliary Units for the network connections. There must be a Rev. B 
PCU at each end of a GNA link between host and satellite. The Rev. B 
PCU consists of two Auxiliary Units: A PCUC and a PCUG device. 


There are seven PCUC Auxiliary Unit parameters. The first two parameters 
contain the device code, which is defined in the physical configuration. 
The third and fourth parameters specify the device number. Each of the 
final three parameters is a Unit Characteristic Word (UNCHWRD): 


e UNCHWRD1 


Contains the speed code in the right byte and the clock switch in the 
left byte, as follows: 


Clock Switch = OQ Modem. 
1 PCU connected without Modem. 


Speed code corresponds to the Baud Rate at which the data is 
transmitted. This is shown in the table below. 


Speed Code Baud Rate 


4.8 kps 
9.6 kps 
54.2 kps 
70.9 kps 
76.8 kps 
83.8 kps 
92.2 kps 
102.4 kps 
115.2 kps 
131.7 kps 
153.6 kps 
184.3 kps 
203.4 kps 
307.2 kps 
460.8 kps 


™mMUOWPAOAAMAN OOAHBWDHNH — 


e UNCHWRD2 
Assigned the value: Site-ID + 1 


e UNCHWRD3 


Not used; value should be zero. 
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Parameters one through four are the same as for the PCUC. Parameters 
five and six contain READ and WRITE buffer sizes. Eight is the recom- 
mended value for parameters five and six. Parameters seven through nine 
contain the following Unit Characteristic Word values: 


e UNCHWRD1 


Not used; value should be zero. 


e UNCHWRD2 | | : 
Assigned the value: Site-ID + 1. 


° UNCHWRD3 


Not used; value should be zero. 


Host Node Configuration Parameters 


CGP Configuration 
System Parameters 
System 
Host | /D for | PCUC/PCUG 
Node | This Connection | UNCHWRD2 
GNA Site Node Configuration Values — 
System ID | (#70) (#77) | Sat. #s 1-6 
One o0 | o 4000 i eee 
Satellite | | 
Two 0 | 0 6000 | 2-3-------- 
Satellites 2 
| | 
Three 0 | ) | 7000 | 2-3-4------ 
Satellites | | 
Four 0 | 0 7800 | 2-3-4-5---- 
Satellites | | : 
Five | 0 | 0 7C00 | 2-3-4-5-6-- 
Satellites 
| | 
Six 0 0 | 7E00 2-3-4-5-6-7 
Satellites | | 
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Satellite Node Configuration Parameters 


CGP Configuration 
System Parameters 


| System : 
ID for 

Node | This Connection | PCUC/PCUG 
System Site Node Configuration UCHWRD2 
Name ID | (#70) (#77) | Values 
Satellite 1 | 1 8000 | 1 
No. 1 ! | 
Satellite 2 | 2 8000 | 1 
No. 2 

| | 

Satellite 3 3 8000 1 
No. 3 | | 
Satellite 4 | 4 8000 | 1 
No. 4 | | 
Satellite 5 | 5 8000 | 1 
No. 5 | | 
Satellite 6 | 6 8000 | 1 
No. 6 
Example 


PCU Auxiliary Unit parameters for a network with two satellites and a host. 


Host (Site-/D = 0) 


Aux Unit 5 PCUC Aux Unit 6 PCUG 
Parameters Parameters 

1. NAME 1 (BCD) PC 1. NAME 1 (BCD) PC 

2. NAME 2 (BCD) 10 2. NAME 2 (BCD) 11 

3. DEVNO IN (HEX) 0030 3. DEVNO IN (HEX) 0032 

4. DEVNO OUT (HEX) 0031 4. DEVNO OUT (HEX) 0033 

5. UNCHWRD1 (HEX) OE01 5. READ BUFFER SIZE (HEX) 8 

6. UNCHWRD2 (HEX) 0002 6. WRITE BUFFER SIZE (HEX) 8 

7. UNCHWRDS (HEX) 0000 7. UNCHWRD1 (HEX) 0000 
8. UNCHWRD2 (HEX) 0002 
9. UNCHWRDS (HEX) 0000 
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Host (Site-ID = 0) (Continued) 


Aux Unit 7 PCUC Aux Unit 8 PCUG 


Parameters Parameters 
1. NAME 17 (BCD) PC 1. NAME 1 (BCD) PC 
2. NAME 2 (BCD) 21 2. NAME 2 (BCD) 21 
3. DEVNO IN (HEX) 0034 3. DEVNO IN (HEX) 0035 
4. DEVNO OUT (HEX) 0035 4. DEVNO OUT (HEX) 0036 
5. UNCHWRD1 (HEX) OE01 5. READ BUFFER SIZE (HEX) 8 
6. UNCHWRD2 (HEX) 0003 6. WRITE BUFFER SIZE (HEX) oe 
7. UNCHWRD3 (HEX) 0000 7. UNCHWRD 17 (HEX) 0000. 
8. UNCHWRD2 (HEX) 0003 
9. UNCHWRDS3 (HEX) 0000 
NODE 7 (Site-/D = 17) 
Aux Unit 5 PCUC Aux Unit 6 PCUG 
Parameters Parameters 
1. NAME1 (BCD) PC 1. NAME1 (BCD) PC 
2. NAME2 (BCD) 00 2. NAME2 (BCD) 01 
3. DEVNO IN (HEX) 0030 3. DEVNO IN (HEX) 0032 
4. DEVNO OUT (HEX) 0031 4. DEVNO OUT (HEX) 0033 
5. UNCHWRD1 (HEX) OE01 5. READ BUFFER SIZE (HEX) 8 
6. UNCHWRD2 (HEX) 0001 6. WRITE BUFFER SIZE (HEX) 8 
7. UNCHWRD3 (HEX) 0000 7. UNCHWRD1 (HEX) 0000 
8. UNCHWRD2 (HEX) 0001 
9. UNCHWRDS (HEX) 0000 
NODE 2 (Site-[D = 2) 
Aux Unit 5 PCUC Aux Unit 6 PCUG 
Parameters Parameters 
1. NAME1 (BCD) PC 1. NAME1 (BCD) PC 
2. NAME2 (BCD) 00 2. NAME2 (BCD) 01 
3. DEVNO IN (HEX) 0030 3. DEVNO IN (HEX) 0032 
4. DEVNO OUT (HEX) 0031 4. DEVNO OUT (HEX) 0033 
5. UNCHWRD1 (HEX) QE01 5. READ BUFFER SIZE (HEX) 8 
6. UNCHWRD2 (HEX) 0001 6. WRITE BUFFER SIZE (HEX) 8 
7. UNCHWRDS3 (HEX) 0000 7. UNCHWRD1 (HEX) 0000 
8. UNCHWRD2 (HEX) 0001 
9. UNCHWRD3 (HEX) 0000 


Note that the above units are in addition to the devices that would be normally 
configured for a given node. 
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Start-up Errors When the network is configured and the system booted up, the first user 
on the host node receives one message (on his/her COMDEV) for each 
network link between host and satellite. The first user on each satellite will 
get one message concerning the network link to the host. The following 
message indicates a successfully initialized link: 


NETWORK LINK TO NODE XXXxX INITIALIZED 


XXXX = Site-ID of node at the other end of the link. 


The following message indicates an error in the configuration, or the PCU 
device: 


NETWORK LINK TO NODE XXXX NOT INITIALIZED 


POSSIBLE ERROR **ERROR CALL D012 
MESSAGES --Unable to attach PCUC device. -- 


This means that there is no PCUC unit in the configuration or that the 
PCUC has invalid network parameters. 


**ERROR CALL D013 
--Unable to attach PCUG device. -- 


This means that there is no PCUG unit in the configuration or that the 
PCUG has invalid network parameters. 


**ERROR CALL D014 
~-Unable to access PCU device. -- 


This means that either the PCU device codes in the configuration are incor- 
rect or that the PCU Itself is down. 


**ERROR CALL D303 
--NETWORKING ISNOT INITIALIZED-- 
~-FILE ‘OVLY.PCU.LNO’ IS NOT FOUND-- 


The file OVLY.PCU.LNO containing PCU network overlay is not on the 
system. Networking has not been initialized. 


NOTE No other users may Login until each link is successfully or unsuccessfully 
initialized. 


Example 


(Boot-up on host. Configuration = 4 Satellites) 
****CGOS 200/10**** 

<CTRLL> ) 

*** EMCLEAR *** 
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TYPE DATE AND TIME: MM-DD-YY [,HH:MM] 
1-1-81,8:00 ) 


NETWORK INITIALIZATION IN PROGRESS 


NETWORK LINK TO NODE 0001 INITIALIZED 
NETWORK LINK TO NODE 0002 INITIALIZED 
NETWORK LINK TO NODE 0003 INITIALIZED 
NETWORK LINK TO NODE 0004 NOT INITIALIZED 


**ERROR CALL DO14** 
--UNABLE TO ACCESS PCU DEVICE-- 


**TASK 0 INITIATED** 


There is no PCU board in the system for the fourth link; hence, the error 
message. 


Procedures for building disc packs have not changed under GNA. As 
System Manager, you load the basic software, overlays, component 
libraries, and subfigures on the host and satellite system packs. Major part 
files should be retained on the host; by using Working directories, updated 
major part files are retained only on the host system. 


GNA allows flexibility in locating and accessing data. A user working on a 
satellite node can access data located at the host, as well as at his/her own 
node. From the host, a user can access data stored at any node in the con- 
figuration. Under GNA, access to files on remote nodes can be explicit or 
transparent, depending on System Manager and user needs. Under certain 
circumstances, it is useful to control data access and make the location of 
data transparent to the user. As System Manager, you can implement this 
control by establishing Working Directories for each user. 


Note 


See Section 2, File Naming Conventions/Restric- 
tions. 


The default file searching operation is to search only the local SYSCATLG. 
This means that unless a Working Directory is enabled, files located at 
remote nodes will only be found when the node level is explicitly included 
in the filename. A user may frequently wish to access files on a node other 
than the one he/she is working on. This is particularly true for a user work- 
ing at a satellite node. For such a user, a Working Directory should be set 
up. This will automate the search for files in commonly accessed remote 
locations. 
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CONVENTIONS In a networking environment, it is standard to locate CADDS files as 
FOR CADDS follows: 


e The host node contains the network’s Master Parts Library on one or 
more discs. 


e Each satellite node contains CADDS scratch files, overlay files, and 
subfigure libraries relevant to work done at that node. 


Working Working Directories are particularly important in the GNA environment 

Directories since they define the relationship between file management at the satellite 
and file management at the host. With a Working Directory enabled, a 
user who works at a satellite can create files on either the host or the 
satellite, as is appropriate, and access remote data without knowing its 
location. A Working Directory sets two criteria for the File Manager: 


e The Search List tells the File Manager to search particular nodes, 
volumes, and/or catalogs to locate an existing file. 


e The Create Directory tells the File Manager that new files will reside on 
a specific node, volume, and/or catalog. 


~SEARCH LIST The Working Directory provides a search list for file references. This list in- 
cludes node locations. With an appropriate Working Directory enabled, 
the operator can find a part or subfigure file without knowing whether it is 
located on the host or the satellite. A typical Working Directory search list 
for a satellite node is set up in this order: 


(1) Local part/subfigure library 
(2) Central part/subfigure library 
(3) Local SYSCATLG 

(4) Central SYSCATLG 


The local parts library is searched, then the remote parts library is 
searched, then the local SYSCATLG is searched, and finally, the remote 
SYSCATLG is searched. Generally, this order is the best compromise bet- 
ween performance and convenience. With the local parts library listed 
first, the File Manager should generally be able to locate a parts file on the 
satellite, so that there is no need to transfer the file from the host. 
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A user can have a Local and a Global create directory. Files are created in 
either directory, depending on the option selected when the file is opened. 
The default is to create new files in the Global directory. GNA conventions 
are as follows: 


e Local (temporary) files are created in the Local Create Directory so 
that they remain on the local satellite node. CADDS scratch files 
should be created in this directory. 


e Global (permanent) files are created in the Global Create Directory so 
that they will be filed to the host for access by users on other 
satellites. In CADDS, new parts should be are created in this direc- 
tory. 


ENABDIR is the command that enables a Working Directory. The 
SYSEX EC. BOOTUP and SYSEXEC.LOGIN files enable the following 
standard Working Directory: 


ENABDIR LOCAL, SYSCATLG = L, [0] = G 


This directory is a general guideline for use on a satellite node. The 
elements of this particular command have the following meaning: 


e LOCAL 


When the File Manager searches for an existing file, the local 
SYSCATLG will be searched first. 


SYSCATLG = L 


Informs the File Manager that all temporary files (i.e., the active part 
and its regen) will reside on this satellite. When the File Manager 
searches for an existing file, the local SYSCATLG will be searched 
second. 


e [0] = G 


Informs the File Manager that all newly created permanent files will be 
stored on the host. Therefore, during part filing, the part and its 
associated regen file will be filled to the host. If an existing file is 
referenced, but not found at the satellite, the host SYSCATLG will be 
searched. 


When the Working Directory is enabled, parts that are created or modified 
reside on the host during their first filing. If later requested, the filed part is 
activated and presented at the appropriate satellite. 
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Note 


To view a Working Directory, use the com- 
mand LISTDIR. : 


Example 


An Electrical Schematic (ES) group, a Printed Circuit (PC) group, and a 
Mechanical Design (MD) group all use the same GNA system. Each group 
works on a different satellite node. To facilitate the different types of work 
each group performs, and to facilitate access to remote data, the System 
Manager sets up the following Working Directories in separate files. Each 
file is located in the SYSNEWS.DIRECTORY catalog and referenced from 
the file SYSTEM.&BCD.AUTHORIZE. 


e PC Group 
ENABDIR PC = L, [0].PC = G, SYSCATLG, [0].SYSCATLG 


The PC group creates Global files in the PC catalog on the host. Local 
files are stored at the PC catalog on the satellite. The Working Direc- 
tory search list is set up so that the satellite PC catalog is searched 
first, followed by the host PC catalog, followed by the local 
SYSCATLG, and finally, the host SYSCATLG.If a PC group user 
typed the command: 


EDIT SAM.X 
The File Manager will open the first of these files that it finds: 


e PC.SAM.X 

e [0).PC.SAM.X 
e SAM.X 

e [0].SAM.X 


If none of these files exists, EDIT prints the message: TYPE OK TO CREATE NEW 
File. If the user enters OX, the file [(0].PC.SAM.X will be opened at the 
host, and a temporary file will be opened at the local node. 


e MD Group 


ENABDIR MD = L, [0.MD = = G, SYSCATLG, [0].SYSCATLG 


The MD group creates Global files in the MD catalog on the host. 
Local files are stored at the MD catalog on the satellite. The Working 
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Directory search list is set up so that the satellite MD catalog is 
searched first, followed by the host MD catalog, followed by the local 
SYSCATLG, and finally, the host SYSCATLG. 


e ES Group 
ENABDIR ES, SYSCATLG 


The ES group normally works only at the local node. ES users do not 
usually access data stored at the host, nor do they file data to the 
host. They can still access the host, however, by specifying = [0] as 
the first level of any filename. 


Note 


An equal sign (=) appended to the first level 
of the filename will override the Working 
Directory. Local and Global create directories 
are not specified. By default, the first entry on 
the search list (ES) becomes the Local and 
Global Create catalog. 


In normal CADDS operation, the user has no indication that he or she is 
working in a networking environment. The operator can enter CADDS 
commands and access CADDS databases just as if no network was con- 
figured. Although the Master Parts Library resides at the host, Working 
Directories make it unnecessary for the operator to know the actual loca- 
tion of most data. 


For CADDS to operate efficiently on a GNA system, several objectives 
must be met: The user should be able to access files without knowing their 
location. Therefore, syntax for accessing a part on the host should be iden- 
tical to syntax for accessing a part locally. Part transmission from host to 
satellite or satellite to host should be minimized and timed so as not to in- 
terfere with regular system use. The System Manager plays an important 
part in meeting these objectives. 


GNA will have minimal impact on system performance, provided that the 
system manager controls the timing of file transfers. Satellite node users 
must have access to files in the Master Parts Library, located on the host. 
Copies of appropriate parts, subfigures, and other files from this library 
should be transferred from host to satellite during start-up. Once this 
transfer has taken place, host and satellite nodes need only interact during 
part filing. 


START-UP 


PART 
ACTIVATION/ 
FILING 


CADDS 
Commands 


CADDS 3 
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As each satellite is brought on-line, GETSLIB (See Section 8) is invoked 
from the satellite boot-up execute file SYSEXEC.BOOTUP. GETSLIB 
distributes copies of host node master files to each satellite node. To deter- 
mine which files will be transferred, GETSLIB processes a file called the 
Subfigure Library Directory (SFLD). 


The SFLD is a text file containing a list of catalogs and files to be included 
in the subfigure library of the satellite node. The System Manager controls 
the contents of the SFLD. Different information, or a uniform data set, can 
be sent to various satellites, depending on the contents of the SFLD. The 
SFLD is uniquely associated with a particular satellite under the following 
naming convention: 


SYSTEM.SUBFIG.&BCD.DIRn 
where n is the satellite node Site-ID. 


Part activation and filing will impact system performance if they involve 
part transfer from host to satellite, or from satellite to host. To avoid the 
impact of part activation, GETSLIB should be invoked from the satellite 
boot-up execute files SYSEXEC.BOOTUP, as described above. To avoid 
the impact of part filing between satellite and host, local part filing has 
been developed. 


Generally, the operator who has completed work on a new or modified 
part or subfigure will file that part back to the Master Parts Library. In the 
GNA environment, the Master Parts Library is located on the host; 
therefore, this type of part filing involves transferring the part from satellite 
to host. Local part filing avoids this transfer by temporarily storing the part 
on the satellite. 


CADDS 4 command language is identical in networking and non- 
networking environments. To accommodate local part filing, one new 
command has been added to CADDS 3. 


Generally, the CADDS 3 user types FILE to file a new or updated part to 
the Master Parts Library. In the GNA environment, FILE files the part in the 
user's Global Create catalog, located on the host. Filing the part to the 
host is time-consuming. As an alternative, LFILE may be used. 


LFILE, which is equivalent to CADDS 4 EXIT PART F or FILE PART, files 


_ the new or updated part to the Local Create directory, located on the 
satellite. The part is then located in the catalog named LOCAL; a CADDS 3 


part would have the full name: 


LOCAL.CD3PRTS... 
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When the same part is filed to the host, the local version will be deleted. 
Typing FILE, will file the part to the host and automatically delete the local 
version of the part located on the satellite. 


If the network fails, the satellite will be unable to interact with the host. 
This makes it temporarily impossible to file a CADDS part back to the host. 
When the part filing procedure tries to file the part to the host, a File 
Manager error will be returned. The part filing procedure detects this type 
of an error return and prompts the user to file the part locally. If the user 
types OK, the part will be filed as if he or she had typed LFILE instead of 
FILE. 


Example 


CADDS 3 systems are networked under GNA, but the host node goes 
down. 


n> CADDS ) 


#FILE ) 


**ERROR CALL D100** 
-- NETWORK TASK DOWN 
TYPE OK TO FILE LOCALLY 


#OK ) 
#EXIT ) 


This files the part to the LOCAL.CD3PRTS catalog. When the host is back . 
up, FILE may be re-typed to transfer the part to the host. 


Back-up procedures allow centralized management of systems networked 
under GNA. When an operator backs up the file structure of any node in 
the configuration, important information about saved files is automatically 
preserved and passed to a central location. The FUTIL (archive) option 
generates information about files backed-up on magnetic tape or other- 
wise saved. When ARCHIVE is typed as part of the FUTIL command line, 
the following message is output: 


ENTER NAME OF AN ARCHIVE FILE, OR } TO STOP ARCHIVE 


ARCHINDX 


ARCHIVE 
INDEX 
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Typing the name of a valid archive index file, passes file information to 
ARCHINDX, which is the command used to create and maintain the 
archive index. 


ARCHINDxX is installed by creating an Archive Index to all data stored off- 
line. The System Manager must ensure that there is only one Archive 
Index. The Archive Index must be located on the host node. In conjunction 
with the FUTIL (archive) option, ARCHINDX keeps a record of each file 
that is removed from the system. These files can be stored on magnetic 
tape, a removeable auxiliary disc volume, or a node. 


Once records are written to the archive index file, they can be retrieved 
with ARCHINDX or ARCHSRCH. The following information about each 
file can be stored and retrieved using ARCHINDX and ARCHSRCH: 


FILENAME 


Full filename in standard filename format (can include node level). 


DATE 


Date, and optionally, time of the archiving. To locate file information in 
the archive, the options BEFORE and SINCE are available. 


TYPE File 


Manager file type — hex number between 0 and FF. 


LOCATION 


Storage location of archived file: disc pack, node name, or tape label. 


COMMENT 


Up to 80 characters supplied when the file was archived. 
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INTRODUCTION 


Section 8 
SYSTEM COMMANDS 


The CGOS 200 GNA command syntax is very similar to CADDS 4 graphics 
commands. An operator trained on CADDS 4 can similarly use the 100 + 
standard system commands. Standard conventions facilitate the addition 
of new commands. User-developed commands can be standardized for 
one or all system users. 


Although most O/S commands are entered from the command device 
(COMDEV), the system can be directed to take commands from an 
Execute File (activated with the EXECUTE command). The execute file is a 
standard text file that contains system commands. 


This section summarizes CGOS 200 GNA commands. The summaries are 
grouped by function and followed by detailed individual command descrip- 
tions. Some detailed descriptions are omitted from this manual, but 
presented in other CGOS 200 GNA manuals, as follows: 


* Command is described in this manual 
** Indicates Programmer Reference 
*** Indicates CGOS 200 GNA Operator Manual 


Both the Table of Contents and the Index serve as excellent quick- 
reference sources. On-line documentation will reflect the most recent 
changes to commands described here. 
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BRIEF COMMAND The command descriptions that follow have been placed into eateg ones 
and grouped by functions. 


DESCRIPTIONS 
File Manipulation 


FUTIL O/S LEVEL 


TEXT EDITORS 


OTHER 
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FUTIL is a multi-function file utility. The following FUTIL commands can 
be entered at internal command level (reached by typing: FUTIL )), or at 


O/S level. 


CONVERT*** 


CONVERTB*** 


COPY*** 
COPYTEXT*** 
DELETE*** 
LIST*** 
LISTLP*** 
LISTTEXT*** 


-MOVE*** 


PRINT*** 
PRINTLP*** 


CVTECO*** 
EDIT*** 
LONGEDIT*** 


CHGTYP*** 
COMPARE*** 
DUMPFILE*** 
FILCOM*** 
PACHFILE*** 
PRGCOPY*** 


Copies and converts text files to and from magnetic 
tape. 


Copies and converts binary files to and from magnetic 
tape. 


Copies files. 

Copies text files. 

Deletes files. 

Lists file information. 

Lists file information on printer (HARDEV). 
Lists text file information. 

Moves files. 

Prints text files. 

Prints text files on HARDEV. 


Character-oriented text editor. 


Line-oriented text editor. 


-Line-oriented text editor that handles line lengths of up 


to 256 characters. 


Changes file type. 

Compares two text files, listing differences. 
Examines file contents. 

Compares two binary files, listing differences. 
Lists and modifies files. 


Modifies a text file by removing identical lines that are in 
sequence. 


OTHER 
(Continued) 


Batch/Execute 


File Processing 


Command Table 


Commands 


Peripheral Devices 


TASK-RELATED 


FUNCTIONS 


DEVICE CHARAC- 


TERISTICS 
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RENAME*** 
SORTCAT*** 
SORTFILE*** 


Renames a file or a catalog. 


Sorts catalog entries. 


Sorts a text file. 


CANCEL*** Removes a batch or print request. 

DO*** Generates a system command to process a text or 
overlay file. 

EXECUTE*** Processes a text file as a series of O/S level commands. 

GENCOM*** Generates an execute file. 

PAUSE*** Puts a pause in an execute file where you want the 
system to wait. 

PRNTJOB*** Lists and prints parameters of a job in the batch queue. 

SUBMIT*** Submits a batch request. 

EDITCMTB*** — Edits a command table (CMTB). 

LISTCMTB*** = Prints a CMTB. 

LISTCOM*** Prints active command tables 

SYSCMTB* Adds a CMTB to the system CMTB. 

USERCMTB*** Designates a file as user CMTB. 

ATTACH*** Attaches a device to a task. 

DETACH*** Detaches a device from a task. 

DSABDEV* Disables a device. 

ENABDEV* Enables a device. 

RENAMDEV*** Renames a device taskunitname. 

SETDEV* Sets unit characteristic word values for an attached 


unit. 
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TAPE DRIVE 


PAPER TAPE/ 
PAPER TAPE 
READER 


LINE PRINTER 
(HARDEV) 


Disc Commands 


Information 
Commands 


File Manager 
Commands 
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CHECK*** 


DUMPTAPE*** 
GENSLTAP* 
REWIND*** 
SETTAPE*** 
TAPETYPE*** 


GETPUNCH*** 


SETPUNCH*** 


HARDFILE*** 


FILERCVR*** 
UP*** 


CHKDISC* 
COPYDISC* 
PACHDISC* 
TEST*** 


DATE*** 
HELP*** 
HELPLP*** 
LCLNEWS*** 
SYSNEWS*** 
STATUS*** 


BOOTDEX* 
FMCHECK*** 
FMCLEAR*** 
FMINIT* 
FMRCVR* 


Checks magnetic tape files against the original disc 
copies. oo 


Magnetic tape dump utility. 

Generates a COLDSTART tape. 

Rewinds a tape. 

Changes parity and pack options for tape unit. 
Outputs tape unit information. 

Outputs parity information to a punch paper tape 
device (PPTDEV). 

Sets parity for a punch paper tape device (RPTDEV). 
Declares a file to receive a copy of all system out- 
put to the task. 

Recovers a HARDFILE lost in system crash. 

Sends FORM FEED to HARDEV. 


Verifies a disc pack for use. 


Copies data from one part of disc to another. 


Modifies and/or examines physical disc data. 


Checks system operation and disc access. 


Prints date and time. 

Prints on-line documentation. | 

Prints on-line documentation on HARDEV. 
Outputs current administrative and local news. 
Lists information about the O/S. 


Lists system status information. 


Bootstraps Disc Diagnostic Executive (DDEX). 
Checks validity of files under file manager (FM). 
Clears open files under FM. 

Initializes the FM. 


Recovers file manager. 
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Multi-Volume ATCHVOL*** Attaches an auxiliary disc volume to a task. 
Sonmant DSABVOL*** Disables auxiliary volume. 

DTCHVOL*** Detaches auxiliary volume from a task. 

ENABVOL*** Enables auxiliary volume. 
Programming COMPILE** Compiles a TPL or FORTRAN source file. 
Commands CROSSREF** Lists entry points and external references for object 

files. 

DEBUG** Allows you to monitor and change program execution. 

FORTXREF** FORTRAN cross-reference utility. 

GENINDX** Outputs specified index from program source files. 

LISTLOAD** Searches a text file for file references, then outputs a 

list. 

LOAD** Creates a core image file. 

LOADLIB** Creates a load library. 

RENUMBER**  Renumbers a FORTRAN text file. 

RUN*** Reads an overlay into core and executes. 

TRACE** Traces subroutine calls in an executing program. 
Configuration BLDSYS* Builds on O/S under a new configuration (CFG). 
Commands COPY CFG* Copies a configuration (CFG). 

EDITCFG* Edits a configuration (CFG). 

LISTCFG* Lists a configuration (CFG). 

NEWCFG* Creates a new configuration (CFG). 
Communications 
Commands 
PROGRAMMABLE COMPPCU*** Compares contents of PCU memory to a PCU 
COMMUNICATIONS overlay file in hexload memory. 
enh eX LOADPCU*** Transfers a file to PCU for (optional) execution. 

PCUPCH*** Patches PCU overlay files. 
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GRAPHICS 
NETWORKING 
ARCHITECTURE 
(GNA) 


Protection Facility 
Commands 


Memory 
Processing 
Commands 


Working Directory 
Commands 


Miscellaneous 
Commands 


HEX CONVERSION 


TASK FUNCTIONS 


ERROR 
HANDLING 
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GETSLIB*** 


NETDIAG*** 


NETSTATS*** 


NETTEST*** 
SYSSIZE*** 


AUTHRIZ* 


CHGPROT*** 
EDITACT*** 
LISTPROT*** 


SETPROT*** 
DUMP*** 
SET*** 


DSABDIR*** 
ENABDIR*** 
LISTDIR*** 


FPHEX*** 
HEXCALC*** 


HEXFP*** 


LOGOUT*** 
SELECT*** 


DUMPERR*** 
ERRLOG* 


Maintains current subfigure library at a GNA 


satellite node. 

Exercises a point-to-point network link for diagnosis. 
Outputs timing statistics for a link in a GNA configura- 
tion. 

Exercises network links in a configuration. 

Checks whether sufficient memory is available for a net- 


work task. 


Verifies entries and encodes passwords for Login 
authorization file. 


Changes a file’s protection group. 
Creates, modifies, or deletes access tables. 


Lists your access table and default protection group 
(DPG). 


Changes your DPG. 


Dumps memory. 


Sets memory locations. 


Disables the current working directory. 
Enables the specified working directory. 


Lists the current working directory. 


Converts floating point to hexadecimal. 


Performs arithmetic operations on hexadecimal 
numbers. 


Translates hexadecimal to floating point. 


Terminates a task. 


Sets task parameters. 


Prints system error information. 


Outputs a formatted dump of the system error log. 


\ 


UTILITY 
COMMANDS 


DETAILED 
COMMAND 
DESCRIPTIONS 
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ARCHINDX* Indexes and references files stored on tape or disc. 
ARCHSRCH*** Looks up records in a Data File created with ARCHINDX. 
GENFICHE*** Converts text files to microfiche format on tape. 
HEADER*** Outputs a two page heading. 
lIOTEST*** Tests system |/O handlers. 
OPLOG* Processes the operation's log table. 


SRCHBCD*** — Locates strings in text file(s). 
The command descriptions that follow are arranged in alphabetical order. 


All commands listed in the preceding pages and identified by one star (*) 
are included. 
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ARCHINDX 


PURPOSE 


SYNTAX 


COMMENTS 


DAY-TO-DAY USE 
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Indexes and references files stored on disc or tape. In conjunction with 
FUTIL, itt provides an automatic procedure for indexing files as they are 
backed up. 


ARCHINDX [filename] } 
# Command } 
filename Name of the archive index. 


Command LOCATE or QUIT, or if you are maintaining the archive in- 
dex, ADD, DELETE, PURGE, or FILE. | 


ARCHINDX uses two types of files to store and retrieve information on 
files in the archive: 


e The primary archive index file, filename, all information is stored. This 
can include the storage location, file type, filename, and the date each 
file was archived. 


e Several Key Files for looking up records. There can be a Key File for 
each field in the primary archive index file. The actual number of Key 
Files is determined when the archive index is set up. 


Whenever files are backed up on tape or otherwise saved, the FUTIL 
archive option can be used to generate information for the archive index. 
To find file information records stored in the archive index, use the com- 
mand: 


LOCATE [filename] [/OPTIONS] 


filename Full filename in standard filename format, or to locate all — 
files with one or more common catalog levels, use the 
MATCH option. 
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DAY-TO-DAY OPTIONS 
USE 


, One or more comma-separated entries in the following format: 
(Continued) 


Option = Contents of key field 


DATE 


Date, and optionally, time of the archiving (e.g., DATE =02-28-81 or 
DATE = 02-28-81:14:00:00). To find a record the date, and time if 
given, must be an exact match. For less precise match of dates, use 
BEFORE or SINCE. 


BEFORE 


Locates files archived before date, and optionally, time (same format 
as DATE). | | 


SINCE 


Locates files archived after date, and optionally, time (same format as 
DATE). BEFORE and SINCE may be combined to specify a range of 
dates. 


TYPE 


File manager file type — hex number between 1 and FF (e.g., 
TYPE=3 (Text), TYPE=1 (Catalog)). 


LOCATION 


Storage location of archived file: Disc pack, Node name, or Tape label 
(e.g., LOCATION = TAPE01, LOCATION = *PACK0O33). 


COMMENT 


Matches a comment of up to 80 characters supplied when the record 
was added to the Data File. 


MATCH 


Wildcard specification substituting for O0-n characters after the first 
catalog level of the filename. 


OPTIONS can be entered in any order. 
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ARCHINDX 


DAY-TO-DAY 
USE 
(Continued) 


ADDING 
RECORDS 
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Note 


Each KEY field entered as a LOCATE option 
will speed record lookup. To execute a search 
with only non-Key fields, each record must be 
searched in sequence. In general, this is a 
time-consuming procedure. LOCATE } lists 
the entire contents of the archive index. 


Files are generally added to the archive index using the FUTIL archive 
option. Use ADD to add files manually. ADD options DATE, FILETYPE, 
LOCATION, and COMMENT can be listed in any order. 
SYNTAX 
ADD Filename/DATE,TYPE [,LOCATION, COMMENT]. 


Filename | 


Full filename in standard filename format. 


DATE 
Date, and optionally, time of the archiving (e.g., DATE =02-28-81 or 
DATE =02-28-81:14:00:00). 


TYPE 


File manager file type hex number between 1 and FF (e.g., Type=3 
(Text), Type =1 (Catalog)). 


LOCATION 


Storage location of archived file: Disc pack, Node name, or Tape 
label. 


COMMENT 
User-supplied comment up to 80 characters long. 


ARCHSRCH will prompt for arguments omitted from the ADD command 
line. 


ADDING 
RECORDS 
(Continued) 


COMMENTS 


SYNTAX 
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Example 

n> ARCHINDX } Adds the record TEST.RUN to 
ENTER NAME OF ARCHIVE INDEX: Data File INDEX.ARCHINDX. 
* INDEX.ARCHINDX ) Date and file type are input on 
¢ ADD TEST.RUN/D=01-5-68,T=4) command line. Prompt for 
ENTER COMMENT FIELD: Comment (blank) and Storage 
*) Location F files changes and 
ENTER STORAGE LOCATION FIELD: exits to O/S level. 

* NODES } 

#F ) 

n>} 


There are two steps in each ARCHINDX session: 


e Enter one or more of the above commands. PURGE and LOCATE are 
processed immediately. Other commands will not be processed until 
the end of the session. 


e At the end of the session, type FILE to save the changes, or QUIT to 
quit without saving the changes. 


ARCHINDX uses two characters to prompt for input: 

# is the general prompt. 

* prompts for a specific response to a question. 
Any command or keyword, except DELETE and PURGE, may be issued in 
abbreviated form. ARCHINDX needs only enough of the command name 
to make it unique (e.g., A,AD, or ADD are all acceptable input for the 
ADD command). 
When ARCHINDX asks for an OK response, Y, YE, YES, or OK are all suf- 
ficient affirmative answers. N or NO will suffice for a negative response. 
With critical questions, any other response will cause the prompt to be 
retyped. 
ADD 


Arguments to ADD can be entered in either of two ways: 


Enter ADD ) and let ARCHINDX prompt you for each field of the record. 
In response to the prompt, type only the contents of the field. 


ARCHINDX 


SYNTAX 
(Continued) 


OTHER 
COMMANDS 
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Example 


ENTER FILE TYPE: 


You can enter the filename and OPTIONS on the ADD command line. This 
is the only way to enter options for other commands. Break up multi-line 
commands using a semicolon (;) between syntax elements. 


Example 


ADD TEST.FILE/TYPE =2,D =02-5-81:14:30:00; } 
> ,LOC=TAPE1 


This form of ARCHINDX syntax is optional with ADD, but necessary with 
the LOCATE and DELETE commands. Enter the name of the option, an 
equal sign, and the actual key field: 


Option = Contents of key field 


When entering more than one OPTION, use commas as separators. 
Option names (with applicable commands) are: 


ASK (DELETE) 

BEFORE (LOCATE,DELETE) 
COMMENT (ADD,LOCATE,DELETE) 
DATE (ADD,LOCATE,DELETE) 
LOCATION (ADD, ,LOCATE,DELETE) 
SINCE (LOCATE,DELETE) 
TYPE (ADD,LOCATE,DELETE) 


When ARCHINDX detects a syntax error caused by a typing mistake, it 
retypes the segment of the line preceding the error. The segment accepted 
and retyped with an angle-bracket (>) cannot be erased or typed over. | 
Continuing the line with ) aborts the command. Any other response, in- 
cluding a space, is assumed to be a correction and continuation. 


Example 


#LOC TEST.FILE/TYPE=2,B =02-5-81, AFTER = 02-5-80 ) 


***ERROR CALL 0000 NO SUCH RECORD IN THE INDEX*** 
>LOC TEST.FILE/TYPE =2,B =02-5-81 
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System Manager 
Duties 


As System Manager, you install ARCHINDX by creating the Data and Key 
Files. Normally, there is one Data File per operating system. The Data File 
is created with the command: 


ARCHINDX [Datafilename] } 


If Datafilename is omitted, and no Datafile exists, ARCHINDX prompts the 
user to enter one: 


FILE NOT FOUND, OK TO CREATE NEW ONE? 


After typing YES, enter the names of Key Files, beginning with the Date 
Key File. There are five possible Key Files, but only the Date Key File is 
mandatory. ARCHINDX types this monologue: 


FOR EACH OF THE FOLLOWING FIELDS, ENTER A FILENAME FOR THE KEYFILE TO BE CREATED FOR 
THAT FILE, OR JUST ENTER A CARRIAGE RETURN IF THAT FIELD IS NOT TO BE USED AS A KEY. 


NOTE — DATE FIELD IS REQUIRED 


ENTER FILENAME FOR THE DATE FIELD: 


* 


After prompting for a date field key file, ARCHINDX successively prompts 
for these additional key files: 


e User-supplied comments. 


e Filename 


File type 


e Storage location (disc, tape, and/or node) 


Data and Key fields are created immediately as typed. After entering a 
filename or carriage return in response to each prompt, you are returned to 
the standard ARCHINDX prompt (#). 


Although only the date field key file is required, additional key files will 
speed record lookup. ARCHINDX uses a binary search of key files to find 
records stored in the Data File. A field without a Key File may still be used 
as the basis of a search, but such a search will be very time-consuming, 
since each record must be searched for in sequence. 


Once you've created these files, the FUTIL archive option will provide 
automatic additions to the File Archive, and indexing will be automatic. 
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DELETING Records are deleted with a two-step process. First, the records are flagged 

RECORDS for deletion. Then, with a separate command, any flagged records may be 
physically deleted. Flagged records cannot be listed with the LOCATE 
command. To flag the records: 


DELETE [filename] [/OPTIONS] 


Arguments (filename and OPTIONS) are the same as for LOCATE, with 
the addition of an ASK option to prompt for user approval regarding dele- 
tion of individual records. 


When a significant number of records are flagged, you may want to free 
disc space by physically deleting flagged records. Do this with the PURGE 
command: 


# PURGE <CR> 
HEE PURGE KH 
DO YOU REALLY WANT TO PURGE NOW? Y ) 


# 


PURGE should generally be run as a background job. 
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PURPOSE 


SYNTAX 


COMMENTS 
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Verifies entries/encodes passwords for LOGIN authorization file 
(SYSTEM.&BCD.AUTHORIZE). Run this command each time the 
authorization file is edited. 


AUTHRIZ 


The LOGIN authorization file lists authorized users by name, number, and 
password. It also identifies users access table and default protection 
group. The EDIT command creates the authorization file. Each line in the 
file must have five comma-separated entries: 


Character 
| Entry Limit Field 
Name* 20 ALPHANUMERIC 
Project designation 13 ALPHANUMERIC 
Access table name 20 ALPHANUMERIC HEX, 
ASSIGNED TO USER 

Task LOGIN Directory File 20 USER FILENAME 
(Optional) CHARACTERS 
Default protection group 4 NUMERIC, 

| ASSIGNED TO USER 
Password* 6 NO LIMITATION 


Errors in the authorization file are flagged. Character limits, fields, and 
commas are checked. If a line has errors, all messages appropriate to that 
line are printed, followed by the line itself. Passwords are not encoded for 
lines with errors. When errors are detected, edit and correct the file and 
rerun AUTHRIZ. 


After editing the authorization file, type AUTHRIZ. If no error occurs, 
system returns to command level. 


Note 


See AUTHORIZ On-line documentation. 


*Empty Entries when accounting entries need not be retained. 
(Four commas required.) 
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BLDSYS 


PURPOSE 


SYNTAX 


INPUT/OUTPUT 
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BLDSYS is used to build a new version of the CGOS 200 GNA resident 
O/S from a configuration slot or configuration file created by EDITCFG or 
NEWCEFG. You may build the configuration either for test purposes or for 
executing CGOS 200 GNA. 


BLDSYS Arg 


(The left column defines the procedure; the right column clarifies the 


action.) 
n> BLDSYS ) 


TYPE OK TO SUPPRESS 
PRINT 


TYPE OK TO USE 
NEW SYSTEM 


**OTHER TASK LOGGED IN** 


**TYPE OK TO USE NEW 
SYSTEM** 


Input command with argument. Dialogue begins 


Supresses BLDSYS procedure output which is not 
usually of interest to the user. If OK not typed, 
BLDSYS will build requested system, and output 
BLDSYS data. 


Output after new system is built. If you don’t type 
OK, BLDSYS procedure terminates; system just 
built is lost. (Useful for testing configuration valid- 
ity.) 


If you type OK } and no other task Is logged in, 
BLDSYS: (1) Makes new system the executing ver- 
sion of the O/S. (2) Restarts the new system 
(equivalent to rebooting from disc). 


This message is printed at the COMDEV when any 
other task is logged in. (BLDSYS will not proceed.) 


This response repeated. Make sure other tasks are 
off system, then type OK or }) to quit BLDSYS pro- 
cedure. 


BOOTDDEX 


PURPOSE 


SYNTAX 


COMMENTS 


INPUT/OUTPUT 


BOOTDDEX 
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Bootstraps DDEX (Disk Diagnostic Executive). 
BOOTDDEX 
Only this task may be logged-in. 


(The left column defines the procedure; the right column clarifies the 
action.) 


n> BOOTDDEX } Input command. Dialogue begins. 


OTHER TASKS LOGGED IN. Output when more than one task is logged in. Con- 
trol is returned to system level. | 


BOOTDDEX COMMAND 


ABORTED 

SET CONSOLE SWITCH Implies that only one task is logged-in. 

ZERO 

TYPE OK WHEN SET Ensure that console switch is set and Type OK. The 
system will boot-strap DDEX. Any other response 
aborts command and returns control to system. 

NO DDEX BOOTSTRAP Unless DDEX ts resident on the system primary vol- 

ON DISK ume, the CGOS 200 GNA boot-up message 


appears, followed by this message. 

You may log back into CGOS 200 GNA. 

If DDEX its resident on system primary volume, 
CGOS 200 GNA boot-up message is followed by 
DDEX boot-up message. 


DDEX is now in control of the system. 
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CHKDISC 

PURPOSE Verifies disc pack for use. Checks that every sector can be read, so bad 
sectors may be removed from the file manager disc area. 
CHKDISC may be directly invoked or entered indirectly through FMINIT. If 
logical drive number is omitted, 0 is assumed. ESC followed by QO aborts 
the command. 

SYNTAX CHKDISC [logical drive number] 

MESSAGES These messages are output at the COMDEV: 


DISC READ ERROR =Xxxx Indicates disc READ error YYYY of type XXXX at 
AT SECTOR YYYY sector YYYY. 


If disc READ error occurs in O/S sectors, this 
message Is output: 


CRITICAL SECTOR Output if disc READ error occurs in O/S sectors. 
NON-RECOVERABLE ERROR | 

THIS DISC NOT USABLE 

PROGRAM ABORTED 


CHKDISC returns control to the O/S. Otherwise 
this next message is printed: 


XXXXXXX SECTORS Indicates CHKDISC has checked the number of 
CHECKED sectors Indicated. 
Note 


CHKDISC will only run if no other tasks are 
logged in. 
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PURPOSE 


SYNTAX 


COMMENTS 


MESSAGES 
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Copies configuration from/to a configuration slot or file. When configura- 
tion is copied, control returns to the system. 


COPYCFG Sourcecfg, Destcfg 


Sourcecfg = Configuration slot number or filename for configuration to 
be copied. 


Destcfg = Configuration slot number or filename destination. 
Example 


n>COPYCFG 1,SYS.CFG ) 


Copies a configuration from config. slot 1 file 
to SYS.CFG. 


CONFIGURATION: 1 System response. 
COPIED TO SYS.CFG 


Copies sectors from one part of a disc to another. 

COPYDISC Source, Destination, Sector-count 

Both source and destination are of the format: logical drive number/ 
absolute disc location (DLOC). If the logical drive number is unspecified, 


logical drive 0 is assumed and the format is simply: absolute-dloc. 


DLOCS = 6 hex digits; Sector Count = 8 hex digits; (leading zeros need 
not be entered). 


Any error messages are typed at the COMDEV. System regains control 
after command completion. 
Caution 
This command can destroy irrecoverable 


system or disc data. Use only for extraordinary 
system debugging. 
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DELCFG 


PURPOSE 


SYNTAX 


DSABDEV 
PURPOSE 


SYNTAX 


MESSAGES 
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Clears a configuration definition from a configuration slot or configuration 
file. 


DELCFG Arg 

Where Arg is a configuration slot number or filename. 
Example 

To delete configuration file SYS.CFG, enter: 


n> DELCFG SYS.CFG ) System responds: SyYS.CFG DELETED 


Disables detached unit so that it may not be used. 
DSABDEV device name 


Where device name is 4 character unique device name assigned to the 
device to be disabled. 


These messages are output at the COMDEV: 


ILLEGAL SYNTAX Command string input could not be interpreted. 
INVALID UNIQUE Device name input does not exist on the system. 
DEVICE NAME 

DEVICE ALREADY Device specified is already disabled. 

DISABLED 

ERROR ON DEVICE Device specified cannot be disabled. 

DISABLE 

DEVICE xxxx Device successfully disabled. 

DISABLED 
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EDITACT 


PURPOSE Access table editor which creates, modifies, or deletes access tables for the 
purpose of controlling user access to files/commands. 


SYNTAX EDITACT [Username[,N]] [,C] 
Where username = name of an access table. 
OPTIONS All options must be separated by commas: 


Username Allows entry to an existing access table of the given 
name (equivalent to EU command). 


N Allows entry to a new access table of the given name; 
must be used with username (equivalent to the CU 
command). 


C Automatically updates the bitmap (see Automatic 
Category of Commands; equivalent to CM command). 


COMMENTS e EDITACT, an editor, contains numerous subcommands that enable you 
to create, examine, modify, and delete access tables. 


e An access table, an essential component of file/command protections, 
defines the protection ranges and access types available to a user. (See 
The Protection Facility, Section 6.) 


e Once EDITACT is invoked, unlimited Access tables may be edited, but, 
only one table may be edited at a time. To build an access table, input 
protection group (PG) ranges and corresponding access types. A PG 
range = one or more consecutive PG numbers of the same access type. 


COMMAND 
CATEGORIES 


ENTRY 


Enables user to evoke a new or existing access table. Only one table may 
be currently entered at a time. | 


EDIT 


Used to add, modify or delete PGs and access types in the currently 
entered access table only. 


8-21 


EDITACT 


The information and drawings contained herein are the sole property of Computervision \ 
Corporation. Use of this document is reserved exclusively for Computervision customers 

and personnel. Reproduction of this matter in whole or in part is forbidden without the 

express written consent of Computervision. 


COMMAND UTILITY 


CATEGORIES Lists pertinent information relating to access tables and PGs. 
(Continued) 
AUTOMATIC 


Enables adding to an access table, a specified range of PGs to be 
associated together with their access types, without concern for the 
actual PG numbers. A bitmap, an internal index transparent to the user, 
keeps account of PGs in use. 


Thus, the system can automatically allocate available contiguous PGs 
from a previously reserved block of PGs, or other unallocated PGs to 
accommodate the range and access types required by the user. 


EXIT 


Enables user to exit from one access table and go on to the next without 
leaving EDITACT. 


TERMINATION 
Exits the user from the ACCESS table editor EDITACT) and returns to 
system level. 
PROTECTION 0000-1FFFx 
GROUP RANGE PG’s within this range are generally reserved for system files and com- 


mands. It is strongly recommended that these PG’s be added to an ac- 
cess table only by use of the AT or AMT commands. 


Caution 
Certain protection groups within this range 


must be included in each ACCESS table to 
enable user to operate system (see Section 6). 


2000-7 FFFx 


All PG’s within this range may be assigned and modified in any manner. 
A PG from this range is assigned for user's files/commands. 
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A user’s access to files/commands in a PG is specified by the Access type. 
User access to files/commands is divided into four categories. Any com- 
bination of access types may be used. 


File Access 


W —_ user may write (create or modify) files as well as read and delete. 
R —_ user may read files. 
D — _ user may delete files. 


Command Access 


E — _ execution of system level command allowed (does not pertain 
to execute files). 


Protection Group Access 

C — _ provides ability to change a file’s PG to another PG using the 
CHGPROT command.C must be present in current PG of the 
file and user must have at least READ access to the new PG. 

Part Access 


M —_ user has model access to file (CADDS 4). 


You may input these commands after EDITACT has been entered and the 
prompt (#) is present: 


PG = protection group (AT = acccess types). 


[argument] = argument is optional. 
USERNAME = access table name (up to 20 alphanumeric characters). 
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EDITACT COMMANDS 


Command Name/ 
Category Syntax 


ENTRY 
CREATE USERNAME 
[CU Username] 


EDIT USERNAME 
[EU Username] 


DELETE USERNAME 
DU Username 


REPLACE USERNAME 
RU Username 


EDIT 


ADD RANGE 
Ar pg a [-pb b]/at 


ADD and MERGE RANGE 
AMR pg a I[-pg b]/at 


8-24 


Description 


Creates/enters a new access table, 
labelled Username. Use edit or 
automatic commands to add PG’s to 
the access table. 


Enters existing access table. Username 
to be edited, using edit or automatic 
commands. 

Deletes the existing access table. 


Equivalent to DU followed by CU of 
the original username. 


Adds an explicit range of PGs and PG 


access types to the access table cur- 
rently entered. | 


Adds an explicit range of PGs. If over- 
lap exists, ranges with common 
attributes are combined into a single 
range; non-overlapping ranges are 
listed individually. Thus, each PG is 
listed only once. 


Example: 
Current access table 


1. 2100-2150/RWEG listed 
2. 2200-2210/RWECDP 


EDITACT 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


EDITACT COMMANDS 


Command Name/ 
Category Syntax Description 


Command 
AMR 2120-2205/CDS 


Resulting access table 


1. 2100-211F/RWEDG 
2. 2120-2150/RWECDG 
3. 2151-21FF/CDS 
4. 2200-2210/RWECDP 
ADD TEMPLATE Adds a list of protection group ranges 


and access types from the access table 
user-name to the currently access 
table. 


AT Username This is the recommended method for 
the addition of groups below 2000x by 
copying either of the predefined acess 
tables, Basic or Admin. (See Section 


6). 

ADD and MERGE TEMPLATE Merges a list of ranges from access 
AMT Username table USERNAME to current table (see 
[/line a [-line b]] AT and AMR). 

DELETE LINE Deletes an entry from currently entered 
DL line a [-line b] access table. Single or multiple entries 

DELETE RANGE are deleted by specifying line 
DR pg a-pg b number(s) or protection range(s). If 


using DR, the protection group range 
must be listed exactly as it appears in 
the table. 
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EDITACT COMMANDS 


Command Name/ 


Category Syntax 


MODIFY RANGE 
MR pg a [-pg b] 
MODIFY LINE 
ML line 


UTILITY PRINT 
Plline a [-line b]] 


PRINT USERNAME 
[* ] 
PU [USERNAME] 
line [a [-line b]] 


LIST USERNAME 
LU 


LIST FREE PGS 
LPU [pg a [-pg b]] 


Description 


Modifies an entry in the currently 
entered table by identifying its PG 
ranges exactly as listed in the access 
table or by line number. When range is 
identified, a prompt (=) signals to in- 
put modification in the form: [pg c] 
[-pg d][/attributes] After each 
modification, the line is reprinted. Line 
may be remodified. Terminate modify 
command with an extra }. Errors aren't 
checked until modification process is 
terminated. 


Prints out latest version of entries in 
currently entered access table, or any 
range of line numbers is given. Output 
format = USER: USERNAME line #. 
Start at range-end of range/at. 


Prints contents of indicated table user- 
name. If * used, all existing tables are 
printed. The tables created line during 
current EDITACT will not be printed; 
Original table will be printed for re- 
cently modified tables. 


Lists name, creation, date, time of all 
access tables. 


Scans bitmap, lists PG ranges not 
assigned as of last CM command. This 
list is as accurate as last CM com- 
mand. Start—end of range. 
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EDITACT COMMANDS 


Command Name/ 
Category Syntax 


LIST IN USE PG 
LPU [-g a [-pg b]] 


CREATE BITMAP 
CM 


AUTOMATIC CREATE BLOCK 
CB size 


ADD BLOCK 
AB size/attributes 


REPLACE BLOCK 
RB [size] 


Description 


Scans bitmap, lists PG ranges that are 
assigned to access tables. PGs in the 
reserved block are considered in use. 
Bitmap automatically updated as each 
group used. Output format = start of 
range—end of range. 


Creates bitmap (internal user-trans- 

parent map of all available PGs) by 

reading existing access tables. Use 

command: 

1. Prior to reserving new block of 
PGs. 

2. After deleting PGs, for accurate 
LPF or LPU. 


Caution: Any currently reserved block 
(See CB) is automatically deleted 
following CM. 


Creates reserved block of contiguous 
PGs of length size for AB commands. 
Only one reserved block may exist at a 
time. Use CM command prior to CB to 
insure a current bitmap. Bitmap is 
automatically updated after CB. 


Adds (to access table) next available 
specified range ofcontinguous PGs 
(from reserved block created by CB 
command) and assigns _ indicated 
access types. Reserved block is re- 
duced by size. 


Deletes currently reserved block, 
replacing PGs to available pool, and 
automatically updates bitmap. RB size 
replaces (returns) part of reserved 
block to available pool of PGs. A CB 
size is automatically performed so re- 
maining groups of original block are 
reserved in a new block. 
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EDITACT COMMANDS 


Command Name/ 


Category Syntax _ Description 
ADD NEXT Adds ist available contiguous PG 
' range (noted by _ bitmap)size/ 
AN size/attributes attributes of specified size with access 
types to currently entered access 
table. 
EXIT 
QUIT USERNAME Exit from current table without saving 
QU modifications. If this table is later 


entered without leaving EDITACT, the 
QU table will be intact; otherwise, all 


CREATING A NEW #¢CU username 


ACCESS TABLE 
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will be lost. 
SAVE USERNAME Saves the currently entered access 
SU table on disc. 
TERMINATION 
QUIT Performs a QU command; clears any 
Q reserved block; files the bitmap if no 
modifications occurred since last CM 
commands and returns to operating 
systems. 
FILE | Performs a Q in addition to saving cur- 
F rently entered access table. 
# AT BASIC or ADMIN See Section 6 to choose proper access table. 


A combination of edit, automatic, and utility com- 
mands may be used to add PGs and their attributes 
to the access table. 


# SU 


#F For last table edited. 
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Example 


A variety of techniques may be used to create and edit access tables. 
Access tables created below are from the example depicted in 7he Protec- 
tion Facility, Section 6. 


Numbers associated with access tables are always hexadecimal. Assume 
there is a ) after each line of user input. 


n >EDITACT TABLO, N,C ) 


The access table editor is enabled. Inputting N 


automatically enters the newly created table 
TABLO. C Initializes the bitmap so it will be con- 
tinually updated as protection groups are added. 


# AT BASIC Uses the default access table as a template to add 
ee Na required PGS and their attributes under 2000. This 
00A0-00A0/RE permits system operation for general operators. 


00A1-1FFF/RE 


# AN 1/RE The first unassigned PG’s are automatically deter- 
oe mined and allocated. Consecutive blocks of PG’s 
2002-2003/RWD may be allocated when they are not elsewhere 


# AR 200A-200F/RWD 


200A-200F /RWD 


assigned. 


A specific protection group range and their at- 
tributes are assigned. 


# LPF All unassigned PG’s are listed. 
2010-7F FF 
# CB 100 Reserves a contiguous block of the first 100 


BLOCK = 2010-210F 


# AB 10/RWECD 
2010-201F/RWECD 


#P 


unassigned PG’s for use by the AB command. 
These PG’s may still be accessed by AR command 
without reserved-blocks status. 


A range of the first 10 consecutive PG’s are 
transferred from the reserved block to TABLO. 


Prints the entire current access table. 
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USER TABLO 


1.0000-0000/ RWECD 
2.0020-009F /E 
3.00A0-00A0/RE 
4.00A1-1FFF/RE 
5.2001-2001/RE 
6.2002-2003/RWD 
7.200A-200F/E 
8.2010-201F/RWECD 


# SU 


# CU TABL2 


# AT ADMIN 

USER: ADMIN 
0000-0000/RWECD 
0001-00001/R 
0002-0002/RWECD 
0003-0003/R WECD 
0004-000F/RWECD 
0010-009F/E 
00A0-00A0/RE 
00A1-1FFF/RWECD 
2000-2000/RWECD 


CHONATAWNS 


# AT TABLO/5 
2001-2001/RE 
2002-2003/RWD 
200A-200F/E 
2010-201F/RWECD 


HAMT TABL1/5 
2001-2001/RE 
2002-2004/ RWD 
2005-2005/ RE 
200A-200F/E 
2010-202F/RWECD 


# MR 200! 
11.2001-2001/RE 
=/RWECDS 
11.2001-2001/RWECDS 


#ML 11 
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Files the access table with the name TABLO and 
exits TABLO. EDITACT is 200A-200F/E. 


Note 


The editing of access table TABL1, similarly per- 
formed as TABLO, is left as an exercise to the 
reader. The continuing example assumes that 
TABL1 exists. 


Enters newly created table, TABL2. 


Uses the default access table as a template to add - 
required PGs under 2000. This permits operator-_ 
access to restricted files/commands as well as 
general system operations. 


since TABL2 will generally be a combination of the - 
PG’s of, TABLO and TABL1, the PG’s beginning — 
with line 5 are added and merged into Use PU User- 
name to print the contents of access tables not cur- 
rently entered. 


Any PG above 7FFF may be modified by input of 
PG range or line #. Line may be continually 
remodified until a } with no entry is entered. The P 
command may be used to display ranges and line 
numbers. 


EDITACT ERROR 
MESSAGES 


EDITACT 
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11,.2002-2004/RWD 

= /RWECD 
11.2002-2003/R WECD 

# ML 12 
12.2005-2005/RE 

= /RWECDG 
12.2005-2005/R WECDG 
= -2006 
12.2005-2005/RWECDG 


# DR 200A-200F 

HAMR 201F-2020/RWECDP 
2010-201E/RWECD 
201F-2020/R WECDP 
2021-202F /RWECD 


# F 
n> 
BAD REQUEST 


NO CHAN AVAILABLE 


FILE OPEN 


NO FILE OPEN 


NO BITMAP 


BAD RANGE 


BAD ATTRIBUTES 


NOT FOUND 


Entry deleted. Bitmap is not updated. The overlap- 
ping (and nonoverlapping, if any) portions of 
existing and added ranges are split into separate 
entries or combined according to the attributes. 


TABL2 is filed and EDITACT is terminated. 

Bad input, character or command. 

No file manager channnels are available — an in- 
ternal file manager error. Perform FMCLEAR. 

An access table is currently entered for modifica- 
tion. Table must be completed (SU or QU) to pro- 
ceed. 

No access table is open for edit when an edit, print 
or exit Command was typed. (Use CU, EU, or RU to 


proceed) 


A command requiring a bitmap was typed when no 
bitmap has been created yet. (Use CM.) 


Illegal range was specified: no range, range below 


0, range with end less than start. 


Illegal characters were entered for attributes. 


Range or line number specified cannot be found in 
current access table. 
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RANGE xxxx-yyyy 
OVERLAPS 


LINE NOT ADDED: 
ACT FULL 


NO BLOCK AVAILABLE 
OF REQUESTED SIZE 


NO BLOCK AVAILABLE 
OF REQUESTED SIZE 
LARGEST BLOCK = xxxx 


NO BLOCK 


BLOCK ALREADY EXISTS: 


XXXX-YYVVYy 


BLOCK TOO SMALL 
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Attempted to add a range which overlaps with an 
existing range. 


Open access table is full. No room for more entries. 


Command AN cannot find large enough block to 
meet request. 


Attempted to create a reserved block but no 
available block large enough. 


No reserved block created when requested by AB 
or RB. 


Reserved block already created; only one may 
exist. Use CM followed by CB to reserve a new 
block if desired. 


Attempt to add a range from a reserved block that 
is greater than its size. 
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Configuration editor. 
EDITCFG (ARG) 


Where ARG is an existing configuration slot number or an existing con- 
figuration filename. If ARG is not present, the configuration being edited is 
initialized with these defaults: 


CGP SYSTEM PARAMETERS 


1. TIS SIZE (HEX) = 0800 

2.1OFLAGS (DEC) = 5 

3. TAPE REQ (DEC) = 2 

4.DISC REQ (DEC) = 5 

5. TASKS (DEC) = 1 

6. SWAP INDEX (DEC) = 103 

7.BMS INDEX | (DEC) = 4 

8.BMS INDEX B (DEC) = 1 

9. AUTOLOGOUT(ON =1/OFF=0) (DEC) = 1 
10. SITE-ID FOR THIS NODE (DEC) = -1 

11. CONNECTION CONFIGURATION (HEX) = 0000 


(See Defining System Configurations, Section 6.) 


EDITCFG responds with a prompt (#). You may then input any of the 
following EDITCFG commands: 


ADD SELTYPE Add a selection of type se/type where seltype is one 
of the following: 


DISC: DISC UNIT 
TAPE: TAPE UNIT 
AUX: AUXILIARY UNIT 


DEL SELTYPE,N Deletes the nth selection of type se/type where n 
> 0 and seltype is as for ADD. If the unit deleted is 
the configuration’s default HARDEV, the con- 
figuration’s default HARDEV is set to none. 
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COMMANDS 
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DFHD (N) 


FILE (cfg) 


LIST (seltype) 
or (CTRL) 


MODC 


MODP (seltype,n) 
or (CTRL) | 


QUIT or Q 


Changes the default HARDEV to auxiliary unit n if 
n is present, or to none if nis not present (n =O). 


Checks current configuration for validity and files it 
under cfg which is a configuration slot or filename 
(may not exist yet). If cfg is not present, it is taken 
to be the ARG in the original command. Note that 
EDITCFG does not terminate after the FILE com- 
mand so that a user may create several configura- 
tions while in EDITCFG. 


Lists current configuration or a portion thereof. 
When no argument given, entire configuration is 
listed. If seltype is present (where seltype is as for 
ADD), that portion of configuration is listed. If 
CTRL is present, system parameters are listed. 


Replaces existing portion of configuration (given 
by LIST CTRL) with system default parameters. 
The default parameters may then be changed. Res- 
pond to ENTER OPTION request with CR to main- 
tain old selection. 


Allows modification of the parameters for a selec- 
tion. Use seltype,n (where seltype is as for ADD 
and n =Q), to modify parameters for the nth selec- 
tion of type seltype. Use CTRL to modify system 
parameters. 


Terminates EDITCFG. 


ENABDEV 
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~ENABDEV 

PURPOSE Enables a unit which has been disabled. 

PURPOSE ENABDEV device name 
Where the device name is the 4 character unique device name for the 
device to be enabled. 

MESSAGES ILLEGAL SYNTAX Command string input could not be interpreted. 
INVALID UNIQUE Unique device name does not exist on the system. 
DEVICE NAME 
DEVICE NOT DISABLED Devices cannot be enabled unless they are 

disabled. 

ERROR ON DEVICE Device specified cannot be enabled. 
ENABLE 
DEVICE xx ENABLED Specified device was successfully enabled. 
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ERRLOG 
PURPOSE Produces a formatted dump of system error log. 
SYNTAX ERRLOG [ OPTIONS] 
OPTIONS 
SINCE 


Lists only those errors logged after the since date supplied by user. 
SINCE option must be first option in option list. Supply the since date 
in the form: 


mm-dd-yy:bhh:mmb:ss 


mm = two digit month 

dd = two digit day 

yy = two digit year 

bhh = two digit hour preceded by a space 
mmb = two digit minute followed by a space 
Ss = two digit second 


TYPE 
Lists only specified errors. The actual syntax of this option is: 
DSKO 
TAPE 
INTX 


MAPI 
VGUB 


The TYPE option list depends on the specific errors that ERRLOG Is set 
up to log for your system. 


Example 
ERRLOG SINCE =01-30-80-[:17:42:00], DSKO,MAPI, TAPE 


Type SINCE date: Format mm-dd-yy:bhh:mmb:ss 
01-30-80: 17:42:00 


Type OK to reinitialize Typing OK clears out ERRLOG buffer after DUMP. 
ERRLOG buffer 
OK 
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e A full explanation of errors logged by this command can be found in 
the format file for the specific device. The last four characters that 
make up the last level in SYSTEM.LOG.FORMAT Catalog also make 
up the options used by the TYPE option. 


® SYSTEM.LOG.FORMAT.Xxxx (Where XXXX is replaced by the 4 char 
representation of the device (i.e., DSKO, TAPE..). 
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Clears any file management (FM) files currently marked in use in the file 
structure. 


FMCLEAR [Catalog] [ /{ [Filelist] [/Options] }] 


Filelist = list of subcatalogs and/or filenames within specified Catalog. To 
clear SYSCATLG, SYSCATLG must be input on the command line as the 
catalog level. 


NOLIST Suppresses certain messages resulting from clearing of 
file/catalog entries. (See WESSAGES at the end of this sec- 
tion.) NOLIST responds with its own message in only one 
circumstance: 


TEMPORARY FILE DELETED 
or 
TEMPORARY FILE RENAMED TO: 


This is output if the new version of a file, opened for create 
with supersede, is deleted or renamed. 


e FMCLEAR sets use count to zero; clears file status word and left byte of 
protection word in all files marked in use in file structure. 


e Whenever control passes back to the system command level, the 
system automatically closes any open files, as indicated by entries in the 
FM channels (i.e., unclosed channels). 


e FMCLEAR is run at boot-up time to clear any files left open as a result of 
a reboot or SAVCOR operation where the system was not able to close 
opened files before the system reboot. FMCLEAR can also be run at any 
other time to clear files which have been left open as a result of an incon- 
sistency in either disc file structures or FM channel data structures. 


e FMCLEAR is illegal in an EXECUTE file or when there is an open HARD- 
FILE. 


SINGLE USER 
MODE ONLY 


MULTI-USER OR 
SINGLE USER 
MODE 


RENAMING 


FMCLEAR 
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All other users must be off system: files open on FM channels are cleared 
with no prior check made. When a name is specified, the FMCLEAR 
method is different: 


e BOOT-UP FMCLEAR 


Automatically run when first user logs in. It looks at the FM channels 
to determine what files to clear. Volume entries are also cleared at that 
time. 


e FMCLEAR SYSCATLG or FMCLEAR SYSCATLG//OPTIONS 


Searches entire catalog structure, including any enabled volumes, for 
files to be cleared. Only one user may be logged in (time consuming 
search for large file structures). 


FMCLEAR with a FM Name list searches the specified calalog struc- 
tures on disc for files to be cleared. 


For the following method of FMCLEAR, other users may be on the system. 
Individual catalogs or files may be cleared with other users on the system; 
file manager checks are performed to determine if files are opened on 
channels. 


e FMCLEAR Wholecatalog } 


Clears all levels of catalog Wholecatalog. 


e FMCLEAR Mycatalog/File1,File2 Subcatalog1, File3 ) 


Clears Mycatalog.File1, Mycatalog. File2, Mycatalog.File3. It will clear 
Mycatalog.Subcatalog1 for all levels. 


New temporary files, opened for create with supersede, may be preserved 
by a renaming operation. 


Catalog. filename ; ; a 
ENTER NEW LAST LEVEL This message is output when a file is marked open 


NAME FOR TEMPORARY FILE for create with supersede. 


Input new filename (single name, max. 20 
characters). Filename is checked in CATALOG for 


uniqueness. 
Error message, The new filename is not unique. Provide a different 
followed by filename, or delete the new, temporary file: 


prompt 
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TEMPORARY FILE 
RENAMED TO: 
Catalog.Newname 


ENTER NEW LAST LEVEL 
NAME FOR TEMPORARY 
FILE 


TEMPORARY FILE DELETED 


Catalog.filename 
ORIGINAL FILE CLEARED 


Catalog.Catalogorfilename 
FILE CLEARED or 
CATALOG CLEARED 


Catalog. File 
ORIG FILE CLEARED 


Catalog. File 
WORKFILE DELETED 


FILE MARKED FOR DELETION: 


FILE DELETED 
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The new (or newly revised) filename is unique; the 
new, temporary file is given same file type as the 
original. | 


This is repeated after the error message if the file is 
not unique. 


Output when } is used to delete the new file. 


In either case, the original file is preserved and 
cleared with this message. 


Output for every cleared file or catalog. May be 
suppressed; see NOLIST. 


Results when original version of a file is opened for 
create for supersede. Maybe suppressed; see 
NOLIST. 


File of type ‘FF’ hexadecimal also known as a 
WORKFILE) is unconditionally deleted. May be 
suppressed; see NOLIST. 


If a file is sumultaneously open for read and for 
supersede, and supersede finishes before read, FM 
marks the original file to be deleted when the 
original file is not in use (i.e., when open for read is 
finished). Files of this status, when found by 
FMCLEAR, are always unconditionally deleted with 
this message. May be suppressed by NOLIST. 
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SYNTAX 


~ COMMENTS 
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Threefold: 


e Initializes a primary volume (disc pack) for file management (FM). 


e Initializes an auxiliary volume for file management, enabling multi-disc 


volume usage. 


e Changes volume information for a given disc pack. 


FMINIT 


Only one task may be logged in when FMINIT is executed. In a dialogue 
with the user, parameters are chosen to initialize the file manager and 
CGOS 200 GNA, if this is drive number 0. 


n> FMINIT 


GIVE LOGICAL DRIVE 
NUMBERS (0-7) 
n [,SINGLE] 


***OTHER TASKS 
LOGGED IN*** 
***FILE AREA NOT 
INITIALIZED*** 


Input command. Dialogue begins. 


Respond with logical drive number of volume (disc 
pack) being initialized, or, if SINGLE option is 
selected, with the logical controller number of the 
drives being initialized. Responding with 0, in- 
dicating either logical drive or logical controller, 
initializes the system's primary volume. 


Choose the SINGLE option only if multiple volumes 
will be mounted concurrently on multiple drives of 
a single controller, and will be used as if the various 
volumes constitute a single volume. Therefore, 
volumes on all drives of the controller must always 
be mounted together and always on the same 
drives. The SINGLE option initializes all drives con- 
figured on a given contoller as a single logical drive. 
Once the logical drive number is input, a list of disc 
areas available to the file manager on the requested 
volume or controller is output. 


Output when more than one task ts logged in. 


FMINIT returns to system level. Otherwise, FMINIT 
begins the initialization process: 


8-41 


FMINIT 


The information and drawings contained herein are the sole property of Computervision 
Corporation, Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


COMMENTS TYPE OK IF AN EXISTING 
(Continued) FILE AREA IS TO BE 
PRESERVED 


TYPE OK TO CHANGE PACK 
VOLUME NAME AND/OR 
VOLUME PROTECTION GROUP 


INPUT PACK ID (NOT 
GREATER THAN 20 
CHARACTERS) 


INPUT VOLNAME (=20 CHAR) 
OR } 


INPUT VOLUME 
PROTECTION GROUP 
OR } 


ENTER NUMBER OF DISC 
SECTORS (HEX) PER TASK 
TO BE RESERVED FOR 
TEMPORARY FILES OR } 
FOR NO CHANGE: 
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Type OK to preserve current FM catalog structure 
on this volume. In this case, the pack ID; volume 
name; protection group; current disc partition 
(expressed as the number of sectors reserved, per 
task, for temporary files); and disc areas currently 
used by file manager are displayed. This message 
follows: 


If you choose not to retain the current volume in- 
formation or preserve existing file areas on the 
volume, you are asked to input a pack ID. The pack 
ID must be no more than 20 characters and may 
contain blanks. If the current file areas are being 
preserved, a) will retain the current pack ID. Other- 
wise, you must input a volume name. 


The volume name must begin with an asterisk * 
and be less than or equal to 20 characters, in- 
cluding the *. It cannot contain any blanks. If the 
current file areas are being preserved, a } will retain 
the current volume name. Otherwise, you must 
input a Protection Group: 


The volume name and OR ) protection group are 
only used for accessing auxiliary volumes in a 
multi-volume environment, but are required for all 
volumes. If the current file areas are being pre- 
served, you are then allowed to change or maintain 
the disc partition: 


You're repeatedly prompted until correct response 
is typed; (a correct response =a non-negative hex 
nmber such that the response multiplied by the 
number of user tasks must not exceed the number 
of disc sectors available to FM (see above for this 
latter figure). Increasing the size of the temporary 
file space has no practical effect since the perma- 
nent (FM) file space is previously established; 
decreasing this size changes only the temporary file 
space. If you are initializing the primary volume, 
additional information is requested regarding 
authorized log-in and system accounting. 


COMMENTS 
(Continued) 


FMINIT 
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If you are not preserving existing file areas, this is 


output: 
TYPE OK TO ENABLE Type OK if the system will require user names and 
mote passwords to log in or to use the file protection 


features of the system. 


TYPE OK TO ENABLE Type OK if the system accounting logs are desired. 
Seo eros Following a positive response, you are asked to 
specify the charge rate: 


TYPE COST/MIN If you are preserving existing file areas, the current 
status (enabled/disabled) of authorized LOGIN and 
accounting logs is displayed. You can type OK to 
change the current status: 


AUTHORIZED LOGIN CURRENTLY 
ENABLED/DISABLED TYPE OK 
TO DISABLE/ENABLE AUTHOR- 
IZED LOGIN ACCOUNTING LOG 
CURRENTLY ENABLED/DIS- 
ABLED TYPE OK TO DISABLE/ 
ENABLE ACCOUNTING LOGS 


TYPE COST/MIN If your response enables accounting logs, you are 
asked to specify the charge rate. 


TYPE OK TO ENABLE Type OK if system requires a boot password for the 
BUMRORIZED CODE first task logging in directly after boot-up. 


ENTER BOOT-uP PASSWorRD If you typed OK above, designate a 6-character 


(CHAR! password. 

AUTHORIZED BOOT-UP If you are preserving the existing file areas, the cur- 
CORRENTE Y ENABEED/ rent status of boot-up is displayed. You 
DISABLED. TYPE OK 

TO DISABLE/ENABLE can type OK to change the current status. 


AUTHORIZED BOOTUP 


If you are not preserving existing file areas, FMINIT 
outputs the following prompts: 


GIVE NUMBER OF DISC The cluster size must be apositive HEX integer that 

BEC CoE CLUSTER is a power of two. The value of the disc cluster size 
represents the number of physical contiguous sec- 
tors which cannot be broken up further for alloca- 
tion purposes, i.e., all files are allocated as 
multiples of this number. 
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FMINIT 


COMMENTS 
(Continued) 


DO YOU WANT DDEX ON 
DISC (YES OR NO)? 


ENTER NUMBER OF DISC 
SECTORS (HEX) PER TASK 
TO BE RESERVED FOR 
TEMPORARY FILES OR } 
FOR DEFAULT: 


TYPE OK TO INITIALIZE 
FILE AREA (ANY EXISTING 
FILES ON THIS DRIVE 
WILL BE LOST) 


***FILE AREA NOT 
INITIALIZED*** 


FILE AREA INITIALIZED 


TYPE OK TO RUN CHKDISC 
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This prompt asks if space should be reserved on 
disc for the Disc Diagnostic Executive (DDEX) 
operating system (see Section 3). 


If you type YES, and there’s no DDEX area on disc, 
an area for DDEX is reserved. If a DDEX area was 
already on disc, it will be preserved. If you type NO, 
and there was no DDEX on disc, no space is 
allocated for it. However, if there was a DDEX 
area, it will be lost. 


You are then asked to partition the disc: 


You will be repeatedly prompted until a correct 
reponse is typed. | 


If you wish to avoid initialization at this point, type 
a}. FMINIT prints the following message and 
returns to system level. 


Output when file area is initialized, along with the 
pack ID, volume name, protection group, creation 
date and time, and sectors per task for temporary 
files (disc partition). 


If you are initializing the system primary volume, a 


_ basic set of access tables, a default authorization 


file, and accounting files are created for the file 
manager, and the CHKDISC and CD3INIT com- 
mands are automatically executed, eventually 
returning you to system level. 


If an auxiliary volume is being initialized, FMINIT 
gives you the option to run the CHKDISC com- 
mand: 


If you type OK, the CHKDISC command is 
executed and control returns to the system level. 
Otherwise control returns directly to system level. 


FMINIT 
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MESSAGES If the file area is not successfully initialized by FMINIT, a message ts output 
to that effect, and the disc is not changed in any way. Other error 
messages may be output during FMINIT. Generally, if there is an error ina 
numerical value input, the appropriate system error number is printed 


followed by the message: 


***INPUT ERROR RETRY*** 
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Recovers the system primary (logical drive 0) file management areas when 
required by Login procedures. 


FMRCVR 


Only one task may be logged in (task must be logged in with system 
default entry). FMRCVR assumes that an FM structure already exists on 


disc. 


(The left column defines the procedure; the right column clarifies the 


action.) 


n> FMRCVR 


TYPE OK TO CHANGE PACK 
ID, VOLUME NAME, AND/OR 
VOLUME PROTECTION GROUP 


AUTHORIZED LOGIN 
CURRENTLY (ENABLED, 
DISABLED) TYPE OK TO 
(DISABLE,ENABLE) 
AUTHORIZED LOGIN 


ACCOUNTING LOGS 
CURRENTLY (ENABLED, 
DISABLED) TYPE OK TO 
(DISABLE, ENABLE) 
ACCOUNTING LOGS. 


TYPE COST/MIN 


Input FMRCVR command. The pack ID, volume 
name, and volume protection of current FM struc- 
ture is printed. 


OK changes any or all of these parameters (for- 
mats described in the FMINIT command). } leaves 
them unchanged. 


OK reverses the state of authorized LOGIN.) leaves 
it unchanged. 


OK reverses the state of accounting logs. } leaves © 
status unchanged. If account logs are still enabled 
after response, you’re asked to specify rate: 


Ends dialogue. FMRCVR sets CGOS flag in the 
DDEX area of the disc; re-enables file management 
areas; returns to system level. 


GENSLTAP 
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SYNTAX 


COMMENTS 


INPUT/OUTPUT 
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The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


Generates a self-loading system tape (also known as a COLDSTART tape) 
containing all O/S overlays, data on disc, and data not stored in the file 
structure. 


GENSLTAP Tapename [,Filename] 
Where Tapename = task name for tape unit to be used. 


e A self-loading tape is generated; messages listing system disc areas are 
saved or output. Control automatically returns to the system. 


e The 12 configurations currently resident in configuration slots are saved 
as part of the GENSLTAP. 


e |f Filename exists, it must be the name of a configuration slot or con- 
figuration file which will be placed in configuration slot 0 on the self- 
loading tape. When Filename is not present, configuration currently in 
slot 0 is used. 


Note 
The system version number on the self-loading 


tape will be the current system version 
number. 


(The left column defines the procedure; the right column clarifies the 
action.) 


n> GENSLTAP Input command (see above SYNTAX). 
TYPE OK TO CHANGE A default name, number, and password is 
DEAE) LOIN iEN ny associated with each COLDSTART tape that must 


be used for LOGIN when there is no file manager. If 
the protection facility is to be enabled, the default 
LOGIN name should be changed for added secu- 
rity. The original COLDSTART tape should be 
secured. 
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TYPE NAME,NUMBER 


TYPE PASSWORD 


This signifies that the LOGIN entry for the CGOS 
200 GNA being saved is used (unless you typed OK 
to the above question). The name and number you 
respond with will be stored on the tape. 


Respond with desired password. Either of these 
messages may be answered with a } (i.e., a null 
entry). The tape then proceeds. 


When the tape is finished, the original default entry 
for the O/S residing on the pack is restored. 


GETSLIB 


PURPOSE 


SYNTAX 


COMMENTS 


GETSLIB 
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Maintains current subfigure library at a GNA satellite node. 


GETSLIB 


SUBFIGURE LIBRARY MANAGEMENT 


In the GNA environment, part/subfigure disc files reside at each satellite 
node. These files are copies of host node masters, transferred by 
GETSLIB. A satellite subfigure library minimizes Host-to-Satellite file 
transfers. 


Each satellite node should have a unique Subfigure Library Directory 
(SFLD). You maintain the SFLD that resides at the host node. Invoke 
GETSLIB from the satellite boot-up execute file SYSEXEC.BOOTUP. 
During satellite node boot-up, the SFLD is transferred from host to | 
satellite. The satellite node uses the SFLD to establish its subfigure 
library. 


SUBFIGURE LIBRARY DIRECTORY FORMAT 

The SFLD is a text file containing a list of catalogs and files in the 
satellite node’s subfigure library. It is uniquely associated with a satellite 
node under the following naming convention: 


SYSTEM.SUBFIG.&BCD.DIRn 


n = Satellite node site-ID (one digit). 


Non-blank lines in the SFLD specify files for the satellite subfigure library in 
the form: 


CATALOG-NAME-[/FILE-NAME-LIST][/OPTIONS] 


If FILE-NAME-LIST contains two or more names, each name must be 
preceded or followed by a comma. Options include: 


Option Meaning 

REPLACE= YES Replace previous versions of preceding files. 
REPLACE = NO Do not replace previous versions. 

EXCEPT Include all files in CATALOG-NAME, except files 


named in FILE-NAME-LIST. 
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e REPLACE=NO 


SFLD lines are processed faster under REPLACE = NO, since date/time 
comparisons are unnecessary unless the file(s) exist at the satellite site. 


e REPLACE= YES 


Files are transferred only if the host file is more recent than the satellite 
version. At boot-up, differing host and satellite versions of the SFLD 
implies a change in the satellite subfigure library contents. If the host 
and satellite versions of a file differ, the more recent file is selected for 
the subfigure library. A warning message greets the first user to LOGIN 
to the satellite, unless the host file is the more recent version. At either 
node, files specified in the SFLD are always included in the satellite sub- 
figure library. 


e Subfigure Library Files. 


If FILE-NAME-LIST is omitted, every file in CATALOG-NAME is in- 
cluded in the subfigure library. 


A part/subfigure file not specified in an SFLD may still be accessed by 
the satellite. This tool is intended to enhance interactive terminal ses- 
sions rather than to restrict file access. 


Files of other types need not be excluded from an SFLD (you may find it 
useful to transfer files such as COMMAND TABLES, AUTHORIZE 
FILES, EXECUTE FILES, etc. 


If the option is misspelled or there are more than two options on the line, 
an error message is typed and the faulty SFLD line is echoed at the satellite 
COMDEV. 


HELP 
PURPOSE 


SYNTAX 


HELP 
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Prints documentation on your COMDEV. 
HELP 


To Access HELP 


n>HELP ) Type HELP ) in response to a prompt at the Operating 
System (O/S) level (n>). Documentation is printed on 
your COMDEV. 

?| While the HELP program is running, a ?] asks for your in- 


put. Respond with document name, sub-category, or a 
special command (see below). 


A } in response to the ?] exits HELP and returns to O/S 
level. 


e Levels 


HELP uses multiple levels of documentation to explain various O/S 


features. 
HELP (level QO) 
yo N 
fea nN 
/ \ \ 
name name2 jpamed, (level 1) 
/ / 
/ / ‘ 
name3 pees name7 (level 2) 
/ \ 
/ \ 
ppame6 name8 (level 3) 
an 
/ l \ 
name9 namei10 name11 (level 4) 


Each name (name2, name4, name5, name6) may have a text document 
and further sub-category levels beneath it. Terminating names (name1, 
name3, name/7, name8, name9, name10, name11) are documents 
without further sub-categories. 


From any level, only documentation at lower levels can be referenced. 
To get this documentation, type the name of the document in response 
to the ?]. If the name typed has further sub-categories, you are moved 
to the next level. If the name is a document with no further sub- 
categories, you remain at the same level. 
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® To List Documents 


From level 0 (HELP), 


the following commands enable you to access the 


documents described. 


Command 
name 


name2 
name4 named. 
name2 name3. 


@ Examples 


These commands, in 


Description 
Name! printed; you remain at level 0. 


Name2 printed; you go to level 1; the next level 
(name3) is listed for your choice of documents. 


Named printed; you go to level 2; and documents 
at the next level (name6, name8)are listed. 


Names printed; you remain at level 0 (name3 has 
no sub-categories). 


response to the level O HELP prompt ?], will access 


the documents described. 


Command 


?] INFO DEVICES 


?] COMMAND LIST 


Description 


Prints information about system devices; you 
remain at level 0. 


Prints information about the command LIST; 
you remain at level 0. For information on any 
O/S level command mentioned in this manual, 
just type: 


n> HELP COMMAND Commandname } in re- . 
sponse to the O/S prompt. 


SYNTAX 
(Continued) 


HELP 
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e Special Commands 


Several commands make accessing documents more convenient. Type 
these commands in response to the ?] prompt instead of a name: 


/L 

/B 

/R 

/Q 

/S and /A 
/S 
/A 

HELP 


Lists the sub-categories and documents at the current 
level. 


Backs up one level and lists the sub-categories and 
documents at that level. 


Repeats the last text document printed. 
Leaves HELP to return to the O/S. 


HELP has two sets of documentation; system documen- 
tation and other (CADDS, user, etc.) documentation. 


Places you at level 0 of System documentation (the level 
of initial access to HELP). 


Accesses the alternate set of documentation, and puts 
you at level 0. This alternate set includes everything but 
System documentation. Type S to return to System 
documentation. 


Prints this document. 
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LISTALL 


LISTALL 


PURPOSE 


SYNTAX 


OPTION 


COMMENT 


COMMAND 
STRING 


REFERENCE 
FILE FORMAT 
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Lists all exisiting catalogs or files with the same name on a Graphics Net- 
working Architecture (GNA) system. 


LISTALL <option> Command String 
Example 
n>LISTALL < REFERENCE.FILE> MYCATALOG//SINCE =2-15-81 


This command sets up and executes a file that lists any catalog or file in 
MYCATALOG created since 2-15-81 on Networking Nodes 0,1,2 and in the 
directory MYDIRECTORY. 


Users may set up their own reference file to control what Networking 
nodes or directories are searched. The optional reference file is listed on 
the command line delimited by ““<"" and “>”. 


LISTALL will incorporate a command string into a file. The file will then list 
all cases of the command string according to networking nodes or direc- 
tory names listed in a reference file setup by the System Manager. This 
default reference file is named SYSTEM.&BCD.LISTALL. 


The entered command string must be valid relative to the FUTIL LIST 
command. 


The reference file is a text file that includes the nodes or directories to be 
searched, each on a line by itself. 


Example 


REFERENCE.&BCD.FILE 4-22-81 16:41:03 
1![0] 
2!(1] 
3![2] 
4!MYDIRECTORY 


LISTCFG 
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LISTCFG 

PURPOSE Lists a configuration slot or file. 

SYNTAX LISTCFG NAME 

COMMENTS e Name can be a number between 0 and 11; this represents a configura- 


tion slot (part of the resident O/S). 
e Name can also be the full name of a file under file management. This file 


must be a type 4 (configuration) file. (See Section 6, Defining System 
Configurations.) 
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NETDIAG 


NETDIAG 
PURPOSE 
SYNTAX 


COMMENT 


INPUT/OUTPUT 


MESSAGES 


ERRORS 
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Exercises a point-to-point network link for diagnosis. 

NETDIAG 

NETDIAG generates a network request to send a buffer to the remote net- 
work task. The remote network task then copies the input buffer into an 


output buffer and returns it to the caller. 


(The left column defines the procedure; the right column clarifies the 


action.) 

n >NETDIAG Input command. Dialogue ensues. 

ENTER LOOP COUNT (DEC) Enter number of transmissions. 

ENTER SITE-ID (HEX) Enter remote site ID. 

ENTER BUFFER SIZE Enter buffer size; must not exceed XXXX (HEX). 


NETDIAG outputs one of two responses after each transmission: 


SUCCESS The transmission is complete and the buffers 
match. 

TRANSMISSION The transmission is incomplete owing to error (see 
below). 


These statistics are output in response to ESC and on completion of all 


transmissions: 
TOTAL TRANSMISSIONS 


SUCCESSFUL UNSUCCESSFUL 


LINE DOWN 
LINE NOT READY 
LINE ERROR 


e Following each transmission, appropriate networking error messages 
are Output. 


e In the event of a configuration error, the system provides host and linked 
node site ID’s (as perceived by each): 


HOST NODE XXXX XXXX 
LINKED NODE XXXX XXXX 


NETSTATS 
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NETSTATS 

PURPOSE Retrieves and displays timing statistics for a point-to-point link in a 
Graphics Network Architecture (GNA) configuration. 

SYNTAX NETSTATS 

INPUT/OUTPUT n > ENTER SITE-ID (HEX) Enter a remote site ID. If you are on a terminal con- 


nected to the host, you can type any configured 
satellite; if you are on a satellite, type only O to 
indicate host. 


TYPE OK TO RESET For valid timing results, reset statistics before run- 
OK } Statistics are output in the format: 

SATISTICS FOR SITE-ID XXXX 

TOTAL NETWORK ACTIVE TIME XXXXXX SEC 

WAITING FOR PCU XXXXXX % 


WAITING FOR SYSTEM CALL XXXXXX % 
TOTAL WORDS TRANSMITTED XXXXXX_ K 
TOTAL # OF TRANSACTIONS XXXKXXXK 


***STATISTICS RESET*** Message output if OK was typed in response to 
reset statistics prompt. 


Caution 


NETSTATS ts only effective for one-direction 
testing in a single-user environment. 
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NETTEST 


NETTEST 
PURPOSE 
SYNTAX 


COMMENTS 


OUTPUT 


NEWCFG 
PURPOSE 
SYNTAX 


COMMENT 


MESSAGES 
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Exercises all network links in a configuration. 
NETTEST 


e For each link in the configuration, NETTEST generates 10 network 
requests to send a buffer to the remote network task. The remote net- 
work task copies the input buffer into an output buffer and returns it to 
the caller. 


e NETTEST is a general tool to get a yes or no answer in a given con- 
figuration. 


As each link is exercised, NETTEST outputs: 


SITE-ID XXXX — SUCCESS or 
SITE-ID XXXX — FAILURE.EXECUTE NETDIAG 


To pinpoint problems indicated by a failure message, execute NETDIAG 
for the link. 


Generates a new system configuration to be placed in a configuration file. 
NEWCFG 

The NEWCFG command initiates a dialogue for configuration definition 
which is identical to that described under Defining System Configurations, 


Section 6. 


When the configuration definition dialogue is completed, this message is 


Output: 
n > TYPE SLOT OR FILE Type either configuration slot or configuration file 
On ENED name where you want to store newly-defined con- 


figuration. ) if you do not want to store configura- 
tion. NEWCEFG terminates. 


OPLOG 
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OPLOG 

PURPOSE Processes operation’s log tables. 

SYNTAX OPLOG 

COMMANDS INITLOG Initializes (zeroes) the accounting files. 


DUMPLOG Produces a formatted dump of the log table. (Included 
in dump: NAME, NUMBER, DATE, TIME, DURATION, 
TASK, AND COST.) 

CLEARLOG Executes a DUMPLOG followed by an INITLOG. 

COMPLOG Completes uncompleted entries in the log table. 


SUMCHARG Calculates total cost per user. 
Note 
OPLOG does work when other tasks are log- 


ged in. All logged tables are access-protected. 


INPUT/OUTPUT (The left column defines the procedure; the right column clarifies the 


action.) 

n> OPLOG Enter command to process log tables. (See 
Accounting Operation/Authorized Login Option, 
Section 3.) 

***OTHER TASKS This message is output tf other tasks are logged in. 

LOGGED IN*** 

n> TYPE COMMAND This message appears if no other tasks are logged 

In, 


Type any command described above. } to ter- 
minate session. 
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PACHDISC 


PURPOSE 


SYNTAX 


COMMENTS 


COMMANDS 
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Physically examines and modifies disc data. 
Caution 

This command can destroy irrecoverable 

system or disc data. Use only for extraordinary 

system debugging. 
PACHDISC DISC ADDR, WORD COUNT [,BASE ADDRESS] 
Where D/SC ADDR is relative to the start of the disc. WORD COUNT is 
the count of words to be read in. BASE ADDRESS is the base location to 


be assigned to the first word. The default base address location is 0. 


After system prompt (#), tyoe DISC ADDR (8 hex digits of the form 
UDSSSSSS), where: 


U = Unit Number 
D = Drive Number 
SSSSSS = _ Absolute Sector Address 


Leftmost digits are 0-filled if unspecified. 


In the following commands, all occurrences of the word LOCN (N = 
decimal digit) represents buffer addresses in the range: BASE ADDRESS 
< LOCN < BASE ADDRESS + WORD COUNT -1 


e DUMP [DUMP] [D] [LOC1 [LOC2]], [LOC1 -LOC2]],... 
Prints all values between LOC1 and LOC2 (in HEX) in the format: 


LOC1 XXXX XXXX XXXKX XXXKX XKXXK XXXK XXXKX XKXXX LOCI +0 
XXXX XXXX XXKXK XXKXK KXXKXK XXKX XXKXK XXXK LOCI +8 XXXX 
XXXX XXXX XXKXK XXKXK KXXKX XXXX XXXX LOCT +10 XXXX 
XXXX XXXKX XKXKXK XXKXK XKXKXK XXKXX XXXKX LOCI +18 XXXX 
XXXX XXXX XXXK XXKXK KXKXKXK KXXKXK XXX 


COMMANDS 
(Continued) 


PACHDISC 
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SEARCH 
SEARCH SR [LOC1 [-LOC2]], [LOC1 [-LOC2]], ...=WALUE 


Prints all buffer locations falling into specified ranges whose contents 
equal value. If ranges are not specified, the entire buffer is searched. 
Output format is: 


LOC1 VALUE 
LOC2 VALUE 


SET 
[SET] 
[SE] LOC = VALUE1,VALUEZ2,...,VALUEN 


Sets contents of buffer locations LOC to LOC+N-1 to VALUE1, 
VALUE2,...,VALUEN. 


SET] 
[ SE] [LOC1 [-LOC2]], [LOC1 [-LOC2]}], ...=VALUE 


SET [ LOC ] [ LOC ] 
SE [LOC1-LOC2] [LOC1-LOC2],...=VALUE 


Sets contents of buffer locations (within specified ranges) to VALUE. 


MOVE 
[MOVE] 
[ M ] COUNT,LOC1,LOC2 


Moves contents of the buffer. COUNT words are moved from LOC1 TO 
LOC2. If LOC2 < LOC1, then the move is made in the order LOC2- 
>LOC1, LOC2+ 1-> LOC1+1, etc. If LOC1 < LOC2, then the move is 
made in the order LOC1+ CNT-1->LOC2+ CNT-1, LOC1+ CNT-2-> 


 LOC2+CNT-Z2, etc. 


QUIT [QUIT] [ Q ] 


Causes an immediate exit to O/S level. All disc is left unchanged from its 
value at PACHDISC initiation. 
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PACHDISC 


COMMANDS 
(Continued) 


MESSAGES 
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e FILE FILE 


Writes back buffer contents to original disc location. Any changes will 
be reflected by disc data. When buffer is written, control is returned to 


O/S level. 


These error messages are output at the COMDEV: 


WORD COUNT TOO BIG 


BAD REQUEST 


BAD COMMAND 


BAD LOC 


DISC CHANGED 


Word count is too large to fit into available buffer 
space for PACHDISC. Words modified = 
[(WORD COUNT + 255)/256 |]*256 


PACHDISC improperly entered or system error on 
disc READ or WRITE. 


Command typed to PACHDISC not recognized. 


Buffer address specified for examination § or 
modification is outside the permitted address 
range. For commands allowing ranges to be 
specified, if either end of a range is beyond the 
limits, Command will not be performed for that 
range. If multiple ranges are specified, the com- 
mand will be performed for all those ranges which 
satisfy the boundary check. 


File command successfully performed. 


RESETPCU 


PURPOSE 


SYNTAX 


MESSAGES 


SETDEV 
PURPOSE 


SYNTAX 


MESSAGES 


RESETPCU 
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Resets a user-specified programmable communications unit (PCU). This 
action clears any previously downloaded PCU code and prepares the PCU 
for a new download. 


RESETPCU <TASKUNITNAME> 
<TASKUNITNAME> = PCU’s task name. 


Example 

n>ATTACH PC,PCOO } Attach PCU to be reset. 

n>RESETPCU PC } Reset it. 

SUCCESSFUL Reset is successful. 

UNSUCCESSFUL Reset unsuccessful. RESETPCU instructs you to 
manually reset the PCU (with switch on PCU 


board). If the PCU reset switch is not accessible, 
the CGP must be rebooted to reset the PCU. 


Sets unit characteristic word values for an attached unit. 

SETDEV Taskunitname, Chr1,Chr2,Chr3 

Where Taskunitname = two-character user assigned task name for unit 
(see ATTACH), and Chr1,2,3 = hexadecimal values assigned to the unit 
characteristic words for this unit. 


See below. Control is automatically returned to the system. 


UNIT CHARACTERISTIC The assignment was successful. 
WORDS FOR Taskunitname 
SET TO Chr1,Chr2,Chr3 


ILLEGAL COMMAND SYNTAX Command string input could not be interpreted. 
INVALID DEVICE NAME Device name specified does not exist. 


See description of unit characteristic words under Defining System Con- 
figurations, Section 6. 
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SYSCMTB 


PURPOSE 


SYNTAX 


COMMENT 


SYSSIZE 


PURPOSE 


SYNTAX 
METHOD 


ERRORS 
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Adds a command table to SYSCMTB, the system command table. 
SYSCMTB is a file manager command table that is searched by user com- 
mands. 


SYSCMTB Filename 
Where Fifename names an existing command table file. 


The file becomes an appendix to SYSCMTB. Its commands are available 
to all users. 


Computes the difference between the system’s physical memory capacity 
and its maximum memory usage under the current configuration. This in- 
formation is used to check whether sufficient memory is available to 
accommodate a network task. 


SYSSIZE 
Memory availability information output. 


No error indicators. 


TAPETYPE 


PURPOSE 


SYNTAX 


METHOD 


COMMENT 


TAPETYPE 
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Outputs information about attached tape units. 
TAPETYPE [TAPENAME] 
TAPENAME User-assigned taskunitname for a tape unit (see ATTACH). 


Information is output in this format: 


[9] [ODD) 
MT: [ ] TRACK, UN PACKED, [ ] 
[7] [EVEN] 


After tape unit information is output, control is returned to the O/S. 
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